home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / panther2.zip / PANTHER.DOC < prev    next >
Text File  |  1993-07-01  |  345KB  |  8,647 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.     ╔═════════════════════════════════════════════════════════════════════╗
  15.     ║                                                                     ║
  16.     ║   ▓▓▓▓▓▓▓   ▓▓▓▓▓▓  ▓▓    ▓▓ ▓▓▓▓▓▓▓▓ ▓▓    ▓▓  ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓     ║
  17.     ║   ▓▓    ▓▓ ▓▓    ▓▓ ▓▓▓   ▓▓    ▓▓    ▓▓    ▓▓ ▓▓       ▓▓    ▓▓    ║
  18.     ║   ▓▓    ▓▓ ▓▓    ▓▓ ▓▓▓▓  ▓▓    ▓▓    ▓▓    ▓▓ ▓▓       ▓▓    ▓▓    ║
  19.     ║   ▓▓▓▓▓▓▓  ▓▓▓▓▓▓▓▓ ▓▓ ▓▓ ▓▓    ▓▓    ▓▓▓▓▓▓▓▓ ▓▓▓▓▓▓   ▓▓▓▓▓▓▓     ║
  20.     ║   ▓▓       ▓▓    ▓▓ ▓▓  ▓▓▓▓    ▓▓    ▓▓    ▓▓ ▓▓       ▓▓  ▓▓      ║
  21.     ║   ▓▓       ▓▓    ▓▓ ▓▓   ▓▓▓    ▓▓    ▓▓    ▓▓ ▓▓       ▓▓  ▓▓      ║
  22.     ║   ▓▓       ▓▓    ▓▓ ▓▓    ▓▓    ▓▓    ▓▓    ▓▓  ▓▓▓▓▓▓▓ ▓▓   ▓▓▓    ║
  23.     ║                                                                     ║
  24.     ╚═════════════════════════════════════════════════════════════════════╝
  25.  
  26.                  PANTHER COMMUNICATIONS SOFTWARE version 2.00
  27.                     (c) Black Cat Software Factory 1992/3
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.     TABLE OF CONTENTS
  74.     -----------------
  75.  
  76.     Copyright Notice and Disclaimer..............................page 3
  77.     Introduction.................................................page 4
  78.     Installing PANTHER...........................................page 8
  79.     Command Line Switches........................................page 14
  80.     Configuring PANTHER..........................................page 17
  81.     Running PANTHER..............................................page 35
  82.     The Dialling Directory.......................................page 37
  83.     File Transfer Protocols......................................page 54
  84.     Internal File Listing........................................page 58
  85.     Raw Logging..................................................page 61
  86.     Scrollback Buffer............................................page 63
  87.     Script Files.................................................page 64
  88.     Keystroke Macros.............................................page 84
  89.     Auto Dialler.................................................page 90
  90.     Terminal Mode................................................page 99
  91.     Ancillary Files..............................................page 102
  92.     About PANTHER................................................page 105
  93.  
  94.     Appendix One - Troubleshooting...............................page 106
  95.     Appendix Two - Error Messages................................page 110
  96.     Appendix Three - Glossary....................................page 123
  97.     Appendix Four - Acknowledgements.............................page 127
  98.  
  99.     Index........................................................page 129
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                        COPYRIGHT NOTICE AND DISCLAIMER
  140.  
  141.     PANTHER (formerly known as COSWORTH) is not "public domain" software.
  142.  
  143.     It is distributed as "freeware", whose meaning is that although no
  144.     charge is made by The Black Cat Software Factory (formerly Opus
  145.     Programs) for this present version, sole and exclusive copyright and
  146.     ownership of PANTHER is retained by The Black Cat Software Factory.
  147.  
  148.     The Black Cat Software Factory grants you, without charge, the right
  149.     to reproduce, distribute and use this version of PANTHER on the
  150.     express condition that you do not receive any payment, commercial
  151.     benefit or other consideration for any such act, and that the wording
  152.     of this copyright notice and disclaimer is not changed in any way
  153.     within the documentation, software or magnetic media.
  154.  
  155.     This product is licensed 'as is' without any warranty of fitness for a
  156.     particular purpose, performance or otherwise. All warranties are
  157.     expressly disclaimed. By using PANTHER you agree that neither The
  158.     Black Cat Software Factory nor any related parties will be liable to
  159.     you or any third party for any use of (or inability to use) or
  160.     performance of this product, any damages whatsoever incurred by the
  161.     use of this product OR ANY FINANCIAL LIABILITY INCURRED BY THE USE OF
  162.     THIS PRODUCT, even if such possibilities are mentioned in advance.
  163.  
  164.     In particular, we wish to draw your attention to the Auto Dialler
  165.     procedure found within PANTHER. This process allows the unattended
  166.     dialling and connection by telephone line communication to a remote
  167.     system or computer. This facility is employed entirely at the users
  168.     own risk and The Black Cat Software Factory will neither incur nor
  169.     bear nor sustain any financial damages or limitations of any nature as
  170.     a result.
  171.  
  172.     The rights to modify PANTHER or employ its component parts in any
  173.     other work are exclusively retained by The Black Cat Software Factory.
  174.     You may not reverse-engineer, disassemble, modify, decompile or create
  175.     derivative works of this product. You also acknowledge that PANTHER
  176.     remains the intellectual property of The Black Cat Software Factory.
  177.  
  178.     By using PANTHER you give your express agreement to the above
  179.     copyright and disclaimer notice.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.     INTRODUCTION
  206.     ------------
  207.  
  208.     Thank you for using PANTHER Communications Software.
  209.  
  210.     PANTHER is a multi-featured communications software package containing
  211.     many features common to a number of other comms applications, together
  212.     with a number of additional features which are, as far as we know,
  213.     unique! It was really written because I couldn't find another comms
  214.     package that had all the features in it I wanted. This being the case,
  215.     it has been written by users FOR users. It is hoped that this fact
  216.     comes through in the software. The main features of PANTHER are;
  217.  
  218.          - PANTHER is issued as FREEWARE. No payment is expected to be
  219.            made by anyone using the software. As far as we are aware, this
  220.            is a first for comms software of any substance.
  221.  
  222.          - It directly supports connections through Mercury
  223.            Communications.
  224.  
  225.          - Has a full featured yet simple script language which is read
  226.            from standard ASCII text files created on just about any text
  227.            editor. In addition, script files can be automatically
  228.            'learned' by PANTHER itself. Even if your script file 'goes
  229.            wrong', a 'smart script' feature will automatically attempt to
  230.            correct the situation!
  231.            The script language includes sounds control
  232.            IF..THEN..ELSE..ENDIFF, WHILE..WEND and REPEAT..UNTIL
  233.            conditional clauses, GOTO..LABEL structures, the ability to run
  234.            *any* DOS command or program, unconditional script halting,
  235.            warning boxes, message boxes, log file messages, printer
  236.            control, macro control (which gives the script the ability to
  237.            control any aspect of PANTHER the user wishes it to have), the
  238.            ability to link from one script file to another automatically,
  239.            assorted emulations of internal DOS commands and assorted
  240.            functions to be used in conjunction with the conditional aspects
  241.            of the language including question boxes, tests for time of day
  242.            or day of the week, file presence/absence, screen contents and
  243.            present macro execution.
  244.  
  245.            There is also a script 'tracing' facility allowing you to
  246.            monitor script file activity and debug script files.
  247.  
  248.          - Internal protocols; Xmodem/XmodemCRC, Xmodem1K, Xmodem1KG,
  249.            Ymodem, YmodemG and Zmodem. (including automatic downloads)
  250.  
  251.          - Internal protocols automatically rename incoming files where
  252.            appropriate in order to avoid overwriting existing files.
  253.  
  254.          - Has an 'Auto Dialler' facility which allows unattended dialling
  255.            using a built-in timer, together with a number of 'safety
  256.            features' which ensure that you aren't on line any longer than
  257.            you wish.
  258.  
  259.  
  260.  
  261.  
  262.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.          - Up to twenty user-defined keystroke macros featuring
  272.            control, arrow, function and ALT+ key emulations, delays and the
  273.            ability to run a specific macro from the command line.
  274.  
  275.          - Machine independent timing.
  276.  
  277.          - Scroll back buffer which automatically adjusts to the amount of
  278.            memory available as well as the ability to automatically dump
  279.            the buffer to disk after each session.
  280.  
  281.          - Internal file lists for automatic transmission
  282.  
  283.          - Complete IEMSI support including an internal IEMSI packet
  284.            editor. (IEMSI is an automated logging on process supported by
  285.            some BBS systems (like RemoteAccess) which allows you to log
  286.            onto the system both automatically and very quickly.
  287.  
  288.          - Configurable serial ports with the ability to modify the
  289.            address, IRQ line and interrupt number.
  290.  
  291.          - Colour screen snapshots and an internal snapshot viewer.
  292.  
  293.          - Intelligent timeslicing for running under any of Windows 3.x,
  294.            DESQview 2.xx, DoubleDOS, VMiX 2.xx, MultiDos Plus 4.xx, DOS 5.0
  295.            Task Switcher, TaskView, TopView, OmniView, Windows NT (who?)
  296.            and (of course) the one and only OS/2 2.x.
  297.  
  298.          - Support for the FIFO 16550A UART chip.
  299.  
  300.          - When executing an external program (either a DOS session or an
  301.            external file transfer protocol program) then PANTHER will
  302.            swap its code out to Expanded Memory, Extended Memory or Disk,
  303.            allowing far more available memory for the child program.
  304.            Typically, PANTHER leaves less that 5K of itself in
  305.            conventional memory.
  306.  
  307.          - Configuration of up to nine external file transfer protocols,
  308.            five dialling prefixes and up to one hundred entries in each
  309.            dialling directory.
  310.  
  311.          - Full internal ANSI, Avatar and VT52 emulation.
  312.  
  313.          - A 'Raw logging' capture system which catches all characters
  314.            received, together with four internal emulation viewers.
  315.  
  316.          - Automatic deletion of user-defined files once uploaded.
  317.  
  318.          - Automatic modem detection on serial port.
  319.  
  320.          - Supports a wide variety of baud rates from 300 up to 57600
  321.            baud.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.          - An easy to use installation program which creates all the
  338.            necessary support files as well as specific Microsoft Windows 3
  339.            PIF files and icons. It also detects whether you are running JP
  340.            Software's 4DOS and modifies the installation accordingly. It
  341.            even writes out a batch file onto your PATH so you can run
  342.            PANTHER from any directory!
  343.  
  344.          - Context-sensitive help.
  345.  
  346.     There are other features but you'll see them as you go along!
  347.  
  348.  
  349.     HARDWARE REQUIREMENTS AND ADDITIONAL SET UP INFORMATION
  350.     -------------------------------------------------------
  351.  
  352.     In order to run PANTHER you will require an IBM PC, XT, AT, PS/2 or
  353.     true compatible with a hard disk with at least 500K of free space.
  354.  
  355.     However, like other communications software systems, PANTHER gives you
  356.     the ability to download files from remote systems and, as such, will
  357.     almost certainly require more free storage space.
  358.  
  359.     When PANTHER executes an external program, either a DOS shell or an
  360.     external protocol, it swaps itself out to EMS, XMS or disk (in that
  361.     order) to allow more memory for the child process called. If there is
  362.     no EMS or XMS then PANTHER will revert to dumping the memory contents
  363.     of your PC out to disk and then reload it when the child process has
  364.     been completed. If your PC only has floppy drives then you will almost
  365.     certainly find that PANTHER will not be able to run external programs
  366.     since there will be insufficient disk space to create the memory dump
  367.     file. If PANTHER has to swap itself out to disk then it will attempt
  368.     to place the swap file in the directory specified by the MSDOS
  369.     environment variable TEMP. If this variable has not been declared then
  370.     the swap file will be created in the root directory of the current
  371.     disk. As a result, you *may* be able to get away with running PANTHER
  372.     on a dual floppy drive with the TEMP variable pointing to the second
  373.     disk drive, although any program executions will necessarily be very
  374.     slow due to the greatly reduced access speeds on floppy drives.
  375.     However, the authors do not regard this as a major drawback as disk
  376.     space must already be available for a file download. For this reason,
  377.     it is recommended that PANTHER is run from a hard disk.
  378.  
  379.     PANTHER also requires a machine with *at least* 525K RAM after DOS has
  380.     been loaded. It is realised that this memory usage is on the high side
  381.     but so much functionality is packed into the software that it uses all
  382.     the memory it can get. To achieve this level of free memory it may be
  383.     necessary to use a version of MS-DOS. PC-DOS or DR-DOS later than
  384.     version 5.0. Alternatively, PANTHER can also be run under versions of
  385.     OS/2 greater than 2.0 which can offer even more free memory than plain
  386.     DOS. (In point of fact, PANTHER was developed under OS/2 2.0)
  387.  
  388.     PANTHER supports up to a maximum of four serial ports (COM1, COM2,
  389.     COM3 and COM4), as many disk drives as you can fit to your machine and
  390.     a parallel printer.
  391.  
  392.  
  393.  
  394.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.     You will also require a modem with certain capabilities. The modem
  404.     must not operate with a forced (high) Carrier Detect signal and must
  405.     not override or ignore the Data Terminal Ready signal either. Baud
  406.     rates between 300 baud to 57600 baud are supported.
  407.  
  408.  
  409.     ASSISTANCE
  410.     ----------
  411.  
  412.     If you require any assistance in using PANTHER then contact ALMAC
  413.     bulletin board in Scotland on 0324-665371 (Running PC Board BBS
  414.     software, up to 14400 baud, 8-N-1, 24 hours a day) where I can be
  415.     found regularly. I may also be contacted on the Ilink International
  416.     Echomail system in the TECH or SHAREWARE conferences or through Usenet
  417.     on mike.dickson@almac.co.uk
  418.  
  419.     Any suggestions for future versions of the software will be gratefully
  420.     received.
  421.  
  422.     I hope you enjoy using PANTHER.
  423.  
  424.     Mike Dickson
  425.     Black Cat Software Factory
  426.     mike.dickson@almac.co.uk
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.     INSTALLING PANTHER
  470.     ------------------
  471.  
  472.     ╔═══════════════════════════════════════════════════════════════════╗
  473.     ║  NOTE - PANTHER is a revised version of an existing               ║
  474.     ║  communications software package formerly called COSWORTH. If     ║
  475.     ║  you are a COSWORTH user then to install PANTHER simply rename    ║
  476.     ║  all your COSWORTH.* files to PANTHER.* and then follow the       ║
  477.     ║  instructions for existing PANTHER users.                         ║
  478.     ╚═══════════════════════════════════════════════════════════════════╝
  479.  
  480.     When you receive PANTHER it is most likely that you have either
  481.     obtained it from a friend or have downloaded it from a Bulletin Board
  482.     (using inferior comms software, of course!) in a compressed archive
  483.     format.
  484.  
  485.     It's assumed that you have unpacked this archive file by now (after
  486.     all, how else would you be reading this?) and have the following
  487.     files;
  488.  
  489.        PANTHER.EXE - The main program
  490.        PANTHER.DOC - This file
  491.        INSTALL.EXE - The PANTHER installation program
  492.        READ.ME     - Installation information
  493.  
  494.     NOTE FOR EXISTING USERS OF PANTHER ONLY
  495.     ---------------------------------------
  496.  
  497.     All you have to do is copy the PANTHER.EXE file over your existing one
  498.     and start up the program. PANTHER will handle all file format changes
  499.     and so on, automatically. Default settings will be made for the
  500.     additional features found in the configuration menus. You can change
  501.     these settings as normal. As easy as that!
  502.  
  503.     NOTES FOR NEW USERS OF PANTHER ONLY
  504.     -----------------------------------
  505.  
  506.     You will not be able to run PANTHER without first running INSTALL.EXE.
  507.     If you try this, be prepared to experience some interesting error
  508.     messages! INSTALL asks you some simple questions about your telephone
  509.     service, your modem and your computer and will detect a few things
  510.     about your hardware. It will then write out all the files that PANTHER
  511.     requires into the appropriate subdirectories.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 8
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.     Installation of PANTHER is entirely automated. To install, first
  536.     create a subdirectory in which you wish to store PANTHER. (We use and
  537.     recommend \PANTHER off the root directory but you could put it
  538.     anywhere!) The DOS command to do this is
  539.  
  540.                                  MD \PANTHER
  541.  
  542.     Then, copy all the above files into that directory with
  543.  
  544.                               COPY *.* \PANTHER
  545.  
  546.     and then change to that directory with
  547.  
  548.                                  CD \PANTHER.
  549.  
  550.     Now that you are 'in' the PANTHER directory, run INSTALL.
  551.  
  552.  
  553.     THE INSTALLATION PROGRAM
  554.     ------------------------
  555.  
  556.     The first thing that appears is a text window telling you what is
  557.     about to happen...
  558.  
  559.  
  560.   ╔═════╣ PANTHER version 2.00  (c) Black Cat Software Factory 1992/3 ╠═════╗
  561.   ║                                                                         ║
  562.   ║              WELCOME TO THE PANTHER INSTALLATION SERVICE!               ║
  563.   ║                                                                         ║
  564.   ║     This program will request you to enter the DOS directories that     ║
  565.   ║      PANTHER will use, as well as some basic information regarding      ║
  566.   ║       your telephone service. It will create any directories you        ║
  567.   ║     specify that do not already exist and will create some example      ║
  568.   ║      files in the process. It will also create a batch file called      ║
  569.   ║      PANTHER.BTM which will be placed into a directory you specify      ║
  570.   ║    on your DOS PATH and which will allow PANTHER to be run from any     ║
  571.   ║      directory. This program will neither examine nor modify your       ║
  572.   ║                         CONFIG.SYS system file.                         ║
  573.   ║                                                                         ║
  574.   ║      It is assumed that you have unpacked the PANTHER archive file      ║
  575.   ║     to the current directory in its entirety. If not, press ESC and     ║
  576.   ║  rectify the situation now, otherwise press any other key to proceed.   ║
  577.   ║                                                                         ║
  578.   ║                                                                         ║
  579.   ╚═══════════════════════╣ ESC ABORTS INSTALLATION ╠═══════════════════════╝
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 9
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.     Notice the bit about PANTHER 'neither examining nor modifying your
  602.     CONFIG.SYS system file.' It's important to realise that this is a
  603.     well-behaved installation program which doesn't go tampering with
  604.     things it really ought to leave well alone. However, a recommendation
  605.     is to include AT LEAST 20 file handles in your CONFIG.SYS file with
  606.     the directive
  607.  
  608.                                    FILES=20
  609.  
  610.     at some point within it. Any fewer than this and PANTHER may
  611.     experience problems opening all file handles it requires. If you don't
  612.     have this line (at least) in your CONFIG.SYS then it's a good idea to
  613.     include it anyway.
  614.  
  615.     To proceed to the next screen, press any key. You will then find a box
  616.     inviting you to input the target directories for the installation; the
  617.     main directory where PANTHER will reside and a further directory where
  618.     a DOS batch file to launch PANTHER will be placed. The former defaults
  619.     to the current directory whereas the latter defaults to the first
  620.     directory found in your DOS %PATH environment variable.
  621.  
  622.    ╔══════════════════════╣ PANTHER Installation ╠═══════════════════════╗
  623.    ║                                                                     ║
  624.    ║  Please specify the directories for this installation of PANTHER    ║
  625.    ║                                                                     ║
  626.    ║ MAIN DIRECTORY       C:\BORLAND\SOURCE\PANTHER\INSTALL.........     ║
  627.    ║ BATCH FILE DIRECTORY C:\BATCH..................................     ║
  628.    ║                                                                     ║
  629.    ║       This is where the main PANTHER program will be stored         ║
  630.    ║                                                                     ║
  631.    ║                                                                     ║
  632.    ╚══════════════╣ F10 TO SAVE, ESC ABORTS INSTALLATION ╠═══════════════╝
  633.  
  634.     Alter or confirm the directories as appropriate. If they don't exist
  635.     then PANTHER will create them for you.
  636.  
  637.     Pressing F10 to confirm takes you onto the next screen. This screen
  638.     asks you to enter the names of all the DOS directories where PANTHER
  639.     will store and look for files...
  640.  
  641.     ╔══════════════════════╣ PANTHER Installation ╠══════════════════════╗
  642.     ║                                                                    ║
  643.     ║    Please specify the directories for installation of PANTHER      ║
  644.     ║                                                                    ║
  645.     ║ MAIN DIRECTORY     C:\PANTHER                                      ║
  646.     ║ BATCH DIRECTORY    C:\BATCH                                        ║
  647.     ║ UPLOAD DIRECTORY   C:\PANTHER\UPLOAD..........................     ║
  648.     ║ DOWNLOAD DIRECTORY C:\PANTHER\DOWNLOAD........................     ║
  649.     ║ SCRIPT DIRECTORY   C:\PANTHER\SCRIPTS.........................     ║
  650.     ║ PROTOCOL DIRECTORY C:\PANTHER\PROTOCOL........................     ║
  651.     ║                                                                    ║
  652.     ║            This is where file uploads will be made from            ║
  653.     ║                                                                    ║
  654.     ║                                                                    ║
  655.     ╚══════════════╣ F10 TO SAVE, ESC ABORTS INSTALLATION ╠══════════════╝
  656.  
  657.  
  658.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 10
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.     You can move the highlight bar up and down using the arrow keys and
  669.     can edit the names of the directories as you wish. The entries are
  670.     already filled in with default values and we recommend you do not
  671.     change them unless you have good reason to. The entries for the MAIN
  672.     and BATCH DIRECTORY will reflect the previous choices and cannot be
  673.     changed.
  674.  
  675.     Once you are happy with the directories, press F10 to continue. ESC
  676.     aborts the installation process completely. If you press F10 then up
  677.     comes the next screen...
  678.  
  679.   ╔════════════════════════╣ PANTHER Installation ╠════════════════════════╗
  680.   ║                                                                        ║
  681.   ║                                                                        ║
  682.   ║    What is the fastest baud rate your modem supports?                  ║
  683.   ║    300 1200 2400 4800 9600 14400 19200 38400 57600                     ║
  684.   ║    Does your exchange support tone or pulse dialling?  Tone Pulse      ║
  685.   ║    What serial port is your modem connected to?  COM1 COM2 COM3 COM4   ║
  686.   ║    What's your name? JOE BLOGGS....................................... ║
  687.   ║    Are you a Mercury subscriber?    YES    NO                          ║
  688.   ║    Enter your Mercury code 131,1234567890......                        ║
  689.   ║    (with prefix - eg 131,1234567890)                                   ║
  690.   ║                                                                        ║
  691.   ║                                                                        ║
  692.   ╚═══════════════════════╣ ESC ABORTS INSTALLATION ╠══════════════════════╝
  693.  
  694.     The questions will appear one at a time from the top of the screen, as
  695.     you answer them. The first three are of a 'multiple choice' variety
  696.     and require you to choose one of the responses on the screen by moving
  697.     the highlight block along the screen with the left or right arrow
  698.     keys.
  699.  
  700.     The fastest baud rate your modem supports will be given in your
  701.     modem's manual.
  702.  
  703.     If you are unsure whether you have tone or pulse dialling, choose
  704.     pulse. (Tone dialling plays 'notes' for every number you dial on your
  705.     telephone)
  706.  
  707.     You'll need to enter your name in order to let PANTHER use it in its
  708.     script files (more of which later!)
  709.  
  710.     If you subscribe to Mercury Communications then you can set up PANTHER
  711.     to use the cheaper Mercury connections. In order to connect with
  712.     Mercury, you'll have to let PANTHER know what your authorisation
  713.     number is. Enter it in this box. You'll also have to enter the
  714.     preceding code (which is 131 at the time of writing) and maybe a
  715.     separating comma (,) to pause the modem prior to sending out your
  716.     personal code. If you don't subscribe to Mercury then enter 'N' at the
  717.     'Are you a Mercury subscriber? (Y/N)' prompt.
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 11
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.     Once you have completed all these questions, INSTALL will go ahead and
  734.     create all the directories (if it has to) and files that you have
  735.     specified and that it requires. If INSTALL encounters any problems
  736.     then it will abort with an error message, telling you which action to
  737.     take.
  738.  
  739.     Once INSTALL has run its course it will flash up a small message
  740.     advising you as to what has happened. INSTALL will create the
  741.     following files (following on from our sample default directory
  742.     structure)...
  743.  
  744.     DOWNLOAD     - The directory into which files will be received.
  745.     UPLOAD       - The directory from which files will be sent.
  746.     PROTOCOL     - The directory where you will put your external
  747.                    protocol programs.
  748.     SCRIPTS      - The directory where your script files are stored and
  749.                    read from.
  750.  
  751.     PANTHER.ICO  - PANTHER icon for Microsoft Windows
  752.     PANAUTO.ICO  - PANTHER Auto Dialler icon for Microsoft Windows
  753.     PANTHER.EA   - OS/2 2.0 Extended attributes for PANTHER
  754.     PANTHER.PIF  - PANTHER Program Information File for Microsoft Windows
  755.     PT-PIF.DVP   - PANTHER Program Information File for DESQview
  756.  
  757.     PANTHER.CFG  - PANTHER configuration file
  758.  
  759.     PANTHER.CAP  - PANTHER capture file
  760.     PANTHER.ERF  - PANTHER error file
  761.     PANTHER.LOG  - PANTHER log file
  762.     PANTHER.MAC  - PANTHER macro file
  763.     PANTHER.PHN  - PANTHER dialling directory
  764.     PANTHER.PTL  - PANTHER protocol definition
  765.     PANTHER.SNP  - PANTHER snapshot file
  766.     PANTHER.IEM  - IEMSI session packet definitions
  767.  
  768.     The SCRIPT directory will contain the following files...
  769.  
  770.     ALMAC.SPT    - PANTHER script for Almac BBS
  771.     EAZIHOST.SPT - PANTHER script for Eazihost BBS's
  772.     MISSPOSS.SPT - PANTHER script for Mission Impossible
  773.     OPUS.SPT     - PANTHER script for Opus BBS's
  774.     PC-BOARD.SPT - PANTHER script for PC-Board BBS's
  775.     REMOTEAC.SPT - PANTHER script for Remote Access BBS's
  776.     PISTON.SPT   - PANTHER script for Piston Poppers BBS
  777.     BLUELBL.SPT  - PANTHER script for Blue Label BBS
  778.  
  779.     INSTALL will also write out a DOS batch file into the specified BATCH
  780.     directory called PANTHER.BAT which will allow you to run PANTHER from
  781.     any directory on your disk.
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 12
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.     One thing that INSTALL will *not* do is alter your DOS set up in any
  800.     way. However, one way that you can ensure PATHER will run from any
  801.     part of your computer is to do the following;
  802.  
  803.        - place the main PANTHER directory into your DOS search PATH
  804.        - set up an environment variable %PANTHER to reflect the main
  805.          program directory.
  806.  
  807.     These could be achieved by the following example statements -
  808.  
  809.           PATH=C:\DOS;C:\UTILS....;C:\PANTHER
  810.           SET PANTHER=C:\PANTHER
  811.  
  812.     INSTALL will also detect whether you are running JP Software's
  813.     excellent 4DOS and will DESCRIBE (a 4DOS command) all the files and
  814.     directories it creates, as well as writing out PANTHER.BTM instead of
  815.     PANTHER.BAT. The contents of the batch files are as follows...
  816.  
  817.     PANTHER.BAT (for MS-DOS)
  818.  
  819.             @Echo Off
  820.             REM Batch file to launch PANTHER
  821.             CD C:\PANTHER
  822.             PANTHER.EXE /NOCHECKING %1 %2 %3 %4 %5
  823.  
  824.     PANTHER.BTM (for 4DOS)
  825.  
  826.             @Echo Off
  827.             REM Batch file to launch PANTHER
  828.             PushD
  829.             Cdd C:\PANTHER
  830.             PANTHER.EXE /NOCHECKING %1 %2 %3 %4 %5
  831.             PopD
  832.  
  833.  
  834.     And that's it! From now on, just run
  835.  
  836.                                    PANTHER
  837.  
  838.     followed by any command line arguments you need from the DOS command
  839.     line and you're away!
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 13
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.     COMMAND LINE SWITCHES FOR STARTING UP PANTHER
  866.     ---------------------------------------------
  867.  
  868.     There are several command line switches which can be used in starting
  869.     up PANTHER. These are;
  870.  
  871.     HELP or ?        - Show a brief listing of the switches available.
  872.  
  873.     AUTO <=FileName> - Invoke Auto Dialling facility straight away without
  874.                        running through menus. You may wish to use this
  875.                        switch if you are planning on Auto Dialling more
  876.                        than 24 hours in advance and are using a time
  877.                        switch or other software to do so, or if you wish
  878.                        to Auto Dial over several control files. The
  879.                        argument <=FileName> is used to cause PANTHER to
  880.                        Auto Dial using whatever Auto Dialler Control File
  881.                        is specified. The '.AUT' extension is optional. If
  882.                        the file name is not specified then the file
  883.                        PANTHER.AUT is used.
  884.  
  885.                        For example, to Auto Dial from the command line
  886.                        using the LONGDIST.PHN Dialling Directory you would
  887.                        use the command line
  888.  
  889.                                      PANTHER AUTO=LONGDIST
  890.  
  891.     DIR <=FileName>  - Cause PANTHER to start up using an alternative
  892.                        dialling directory to the default PANTHER.PHN. The
  893.                        '.PHN' extension is optional.
  894.  
  895.                        For example, to start up PANTHER to use the
  896.                        LOCAL.PHN Dialling Directory you would use the
  897.                        command line
  898.  
  899.                                      PANTHER DIR=LOCAL
  900.  
  901.     NOCHECKING       - Disables checking for presence of modem on port
  902.                        prior to its use. When entering Auto Dialler,
  903.                        Terminal Mode or when commencing dialling from a
  904.                        directory, PANTHER checks to see if there is a
  905.                        working modem on the port in question. If it cannot
  906.                        detect one then an error is issued. The method
  907.                        PANTHER uses to detect the modem may not be
  908.                        compatible with older modems and is noticed not to
  909.                        be completely reliable when running PANTHER under
  910.                        Microsoft Windows. If you experience difficulties
  911.                        in this, try starting up PANTHER with
  912.  
  913.                                       PANTHER NOCHECKING
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 14
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.     FILE=FileName    - Automatically read in a file listing from the
  932.                        specified ASCII file. (See the section of this
  933.                        manual on using file lists for more details) For
  934.                        example, if your file listing is called MYFILES.DAT
  935.                        then start up PANTHER with
  936.  
  937.                                    PANTHER FILE=MYFILES.DAT
  938.  
  939.     MACRO=Number     - Start up PANTHER with a macro, thereby allowing
  940.                        entire sessions to be automated without any need for
  941.                        other involvement. The number specified would refer
  942.                        to a defined macro in the macro editor and would be
  943.                        between 1 and 20. (See the section on macros for
  944.                        more information on this useful feature) For
  945.                        example, to start up PANTHER using the keystrokes
  946.                        featured in the fifth macro specified in the macro
  947.                        editor (ALT-F5, in this case) then start up
  948.                        PANTHER with
  949.  
  950.                                           PANTHER MACRO=5
  951.  
  952.     KEYS=<Keys>        Instead of using up a macro 'slot' for the sake of
  953.                        a start up macro, you can define the start up macro
  954.                        on the command line itself using this parameter. The
  955.                        <Keys> can be defined as could any macro, using any
  956.                        of the macro tokens like <DOWN> or <QUIT>, any of
  957.                        the control characters like ^[ or ^M and any other
  958.                        text you like. The only condition here is that you
  959.                        *cannot* use a space in the <Keys> since that would
  960.                        split the parameter itself. Note also that a macro
  961.                        defined in this way will override any previous
  962.                        KEYS or MACRO parameters.
  963.  
  964.     NOCARRIERCHECK   - Prevents PANTHER from checking for a carrier signal
  965.                        on your selected port on starting up. We really
  966.                        don't advise you to use this switch unless you are
  967.                        absolutely certain that your modem works perfectly
  968.                        with PANTHER, even though it has a high carrier
  969.                        signal by default.
  970.  
  971.     DIAG             - Create a diagnostic dump file called PANTHER.DIA
  972.                        for internal use by Black Cat Software Factory in
  973.                        sorting any problems you may have with PANTHER. If
  974.                        you wish to report any problems then it may be
  975.                        useful for you to include this file for the
  976.                        developer's information.
  977.  
  978.     Although these switches can be used in combination without a problem,
  979.     it makes no sense to start up PANTHER with both the AUTO and DIR
  980.     switches as PANTHER will immediately exit back to the operating system
  981.     on completion of the command line Auto Dialler sequence.
  982.  
  983.     Any of the above parameters can be truncated to its first four or more
  984.     initial characters.
  985.  
  986.  
  987.  
  988.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 15
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.     EXIT CODES
  998.     ----------
  999.  
  1000.     When exiting, PANTHER will leave a DOS ERRORLEVEL of 1 if a fatal
  1001.     error caused PANTHER to terminate, otherwise a nominal ERRORLEVEL of
  1002.     zero is left.
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 16
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.     CONFIGURING PANTHER
  1064.     -------------------
  1065.  
  1066.     PANTHER has been designed to allow the user to configure it in the way
  1067.     that best suits his or her needs. Configuration is completely
  1068.     automated and is controlled though the Configuration entry in the main
  1069.     menu.
  1070.  
  1071.  
  1072.     THE PANTHER CONFIGURATION FILE
  1073.     ------------------------------
  1074.  
  1075.     The way in which you use and have set up PANTHER is saved into a
  1076.     configuration file called PANTHER.CFG which MUST reside in the main
  1077.     program directory.
  1078.  
  1079.     Obviously, this file is very important. If it gets lost or corrupted
  1080.     then PANTHER will have no way of knowing how you want it to work. To
  1081.     this end, certain protection measures have been built into PANTHER to
  1082.     ensure that a configuration file is always at hand.
  1083.  
  1084.     When PANTHER starts up, the first thing it does is read in the
  1085.     configuration file. If it cannot find PANTHER.CFG on the main program
  1086.     path, or if it is the wrong size (implying that it has become
  1087.     corrupted) then it generates an error message and creates a
  1088.     configuration file out of defaults. NOTE - these are NOT the defaults
  1089.     you specify in the configuration (obviously!) since they have been
  1090.     lost. PANTHER will then inform you of what it has done and will then
  1091.     launch you straight into the configuration menu to change the settings
  1092.     to those which you prefer. Quitting from the configuration menu will
  1093.     automatically save the PANTHER.CFG file (only under these
  1094.     circumstances) and will put you back into PANTHER as normal.
  1095.  
  1096.     If PANTHER finds that the configuration file is the right size, but
  1097.     that it cannot find PANTHER.EXE on the path defined as the 'program
  1098.     path' (see below) then it generates another error message and again
  1099.     launches you into the configuration menu. This time, since the file is
  1100.     the right length, it uses the settings it has found, thereby saving
  1101.     you from re-entering them all again. (The failure to detect
  1102.     PANTHER.EXE may be attributed to third party DOS software which allows
  1103.     you to rename directories. If you rename the main PANTHER program
  1104.     directory then you'll get this kind of error.)
  1105.  
  1106.     However, this kind of error is rare. You'll probably find that PANTHER
  1107.     reads the configuration file every time, but these safeguards are
  1108.     there 'just in case'! Now who says that programmers don't care? (Okay,
  1109.     okay, hands down...)
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 17
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.     HOW TO CONFIGURE PANTHER
  1130.     ------------------------
  1131.  
  1132.     PANTHER has been designed to allow the user to configure it in the way
  1133.     that best suits his or her needs. Configuration is completely
  1134.     automated and is controlled though the Configuration entry in the main
  1135.     menu.
  1136.  
  1137.     Selecting this brings up a further sub menu which looks like this;
  1138.  
  1139.                 ┌────────────────────────────────────────────┐
  1140.                 │             CONFIGURATION MENU             │
  1141.                 │        Select Choice or ESC to Quit        │
  1142.                 │                                            │
  1143.                 │     >F1   Select Serial Port               │
  1144.                 │      F2   Modem Strings                    │
  1145.                 │      F3   Colours                          │
  1146.                 │      F4   Protocols                        │
  1147.                 │      F5   Paths                            │
  1148.                 │      F6   Program Settings                 │
  1149.                 │      F7   Directory Defaults               │
  1150.                 │      F8   Edit IEMSI Session Packets       │
  1151.                 │      F9   Save Configuration               │
  1152.                 │      F10  EXIT                             │
  1153.                 │                                            │
  1154.                 └────────────────────────────────────────────┘
  1155.  
  1156.     Each choice can be selected by either pressing the associated function
  1157.     key or by moving the scroll bar up and down using either the arrow
  1158.     keys, mouse or space bar and then pressing enter over the required
  1159.     choice. We'll examine each of these choices in turn.
  1160.  
  1161.  
  1162.     PORT
  1163.     ----
  1164.  
  1165.     This brings up yet another scrolling menu which offers you the choice
  1166.     of which port to use.
  1167.  
  1168.                      ┌──────────────────────────────────┐
  1169.                      │         Set Serial Port          │
  1170.                      │                                  │
  1171.                      │       Use serial port COM1       │
  1172.                      │       Use serial port COM2       │
  1173.                      │       Use serial port COM3       │
  1174.                      │       Use serial port COM4       │
  1175.                      │       Set Up Serial Ports        │
  1176.                      │                                  │
  1177.                      └──────────────────────────────────┘
  1178.  
  1179.     Note that there is no need to run any program prior to PANTHER to
  1180.     locate the addresses of ports COM3 and COM4 in your machines memory -
  1181.     PANTHER does this for you automatically.
  1182.  
  1183.  
  1184.  
  1185.  
  1186.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 18
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.     The final choice in this menu allows you to modify the way PANTHER
  1196.     interacts with your hardware by altering the addresses, IRQ lines and
  1197.     interrupt vector for each of your ports through the following table;
  1198.  
  1199.       ┌─────────────┤ F10 TO SAVE ENTRIES, ESC TO ABORT ├─────────────┐
  1200.       │ COM1  Address 03F8    IRQ Line No 4.      Interrupt No 12     │
  1201.       │ COM2  Address 02F8    IRQ Line No 3.      Interrupt No 11     │
  1202.       │ COM3  Address 03E8    IRQ Line No 4.      Interrupt No 12     │
  1203.       │ COM4  Address 02E8    IRQ Line No 3.      Interrupt No 11     │
  1204.       └───────────────────────────────────────────────────────────────┘
  1205.  
  1206.     We will *not* discuss what these settings do since we would not wish
  1207.     to encourage those who do not know what they are to tamper with these
  1208.     settings. Suffice to say that only those who know what they are doing
  1209.     should mess with these since we cannot guarantee PANTHER will work if
  1210.     you alter them and neither will we guarantee what will happen to your
  1211.     machine should you alter the addresses or IRQ's to some critical
  1212.     points. PANTHER ought to work on 99% of machines with the default
  1213.     settings and there ought to be no need to alter these numbers.
  1214.  
  1215.     MODEM STRINGS
  1216.     -------------
  1217.  
  1218.     This brings up a larger screen which invites you to enter the strings
  1219.     which control the use of your modem. Some modem control strings will
  1220.     require the use of a terminating return character or other control
  1221.     characters. This is difficult to enter in a data entry format like
  1222.     that which PANTHER uses, so a '#' character is used in place of a
  1223.     return character. Once you save the modem strings then the character
  1224.     is interpreted and, if you re-examine the strings, you will see that
  1225.     the '#' characters are replaced by the 'musical note' character, being
  1226.     ASCII 13 - the return character.
  1227.  
  1228.     To insert control characters into your modem strings use the caret
  1229.     notation. For example, ^M is interpreted as CTRL-M, which would insert
  1230.     a return character. To insert a caret into your strings use two carets
  1231.     together, as in ^^. Some of the more familiar control characters are
  1232.  
  1233.                      ^M        CR        Carriage Return
  1234.                      ^J        LF        Line Feed
  1235.                      ^L        FF        Form Feed
  1236.                      ^[        ESC       Escape
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.     The illustration below gives some examples.
  1262.  
  1263.  
  1264.    ┌───────────────────┤ ENTER MODEM CONTROL STRINGS ├────────────────────┐
  1265.    │ RESET             ATZ^M............................................. │
  1266.    │ INITIALISATION    AT S7=60 S0=0 V1 X3^M............................. │
  1267.    │ HANG UP           ~~~+++~~~AT H0^M.................................. │
  1268.    │ MODEM OK          OK.............    MODEM ERROR     ERROR.......... │
  1269.    │ PREFIX 1          ATDT.............................................. │
  1270.    │ PREFIX 2          AT&M0DT........................................... │
  1271.    │ PREFIX 3          ATB0DT............................................ │
  1272.    │ PREFIX 4          AT&N3DT........................................... │
  1273.    │ PREFIX 5          .................................................. │
  1274.    │ BUSY STRINGS      NO CARRIER, BUSY, RINGING......................... │
  1275.    │ PORT LOCKED?      N                                                  │
  1276.    │                                                                      │
  1277.    │ CONNECT 300       CONNECT^M......    CONNECT 1200    CONNECT 1200... │
  1278.    │ CONNECT 2400      CONNECT 2400...    CONNECT 4800    CONNECT 4800... │
  1279.    │ CONNECT 7200      CONNECT 7200...    CONNECT 9600    CONNECT 9600... │
  1280.    │ CONNECT 12000     CONNECT 12000..    CONNECT 14400   CONNECT 14400.. │
  1281.    │ CONNECT 19200     CONNECT 19200..    CONNECT 38400   CONNECT 38400.. │
  1282.    │ CONNECT 57600     CONNECT 57600..                                    │
  1283.    │                                                                      │
  1284.    │ MERCURY PREFIX    131,1234567890.................................... │
  1285.    └─────────────────┤ F1 HELP, F10 ACCEPTS, ESC ABORTS ├─────────────────┘
  1286.  
  1287.     For the exact strings required by your particular modem, consult your
  1288.     modem manual. The installation program will fill this table out with
  1289.     default values, but they may not be suitable for your modem. Please
  1290.     check them prior to attempting to dial out using PANTHER!
  1291.  
  1292.     If you need further help then pressing F1 will bring up a help screen
  1293.     summarising the meanings of the individual strings. The modem control
  1294.     strings above are specified as;
  1295.  
  1296.     RESET - This string is sent to your modem when first starting to dial
  1297.             or when starting up in terminal mode, resetting your modem
  1298.             back to it's default settings. Notice that this string (in the
  1299.             above case) is terminated with the interpreted '#' for a
  1300.             return character.
  1301.  
  1302.     INITIALISATION - This is sent to your modem AFTER the RESET string has
  1303.                      been received. It is generally used for initialising
  1304.                      various 'S' registers in your modem, the verbal or
  1305.                      numeric result codes and the result code options,
  1306.                      although it can contain any other modem controls you
  1307.                      wish. Notice that this string (in the above case) is
  1308.                      terminated with the interpreted '^M' for a return
  1309.                      character.
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 20
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.     HANG UP - This is the string that PANTHER will fire at your modem to
  1328.               make it hang up and drop the carrier. However, before doing
  1329.               so, PANTHER will always attempt to hang up by a faster
  1330.               method; it will attempt to lower (that is, turn off) the DTR
  1331.               bit on the selected serial port. This usually drops the
  1332.               lines with most modems. If this fails, however, the HANG UP
  1333.               string will be sent (up to ten times, if necessary!) to drop
  1334.               the line. If this also fails then an error is produced.
  1335.  
  1336.     MODEM OK - This is the string that will be returned by your modem on
  1337.                successful completion of the last command sent. On most
  1338.                Hayes-compatible modems this string will simply be 'OK' but
  1339.                it is best to check with your manufacturer's manual first.
  1340.                Note that you *must* enter something in this field - you
  1341.                cannot just leave it blank. This is to ensure that all
  1342.                commands sent to your modem from the dialling directory are
  1343.                being processed properly.
  1344.  
  1345.     MODEM ERROR - This is the string that will be returned by your modem
  1346.                   on UNSUCCESSFUL completion of the last command sent. On
  1347.                   most Hayes-compatible modems this string will simply be
  1348.                   'ERROR' but it is best to check with your manufacturer's
  1349.                   manual first. Note that you *must* enter something in
  1350.                   this field - you cannot just leave it blank. This is to
  1351.                   ensure that all commands sent to your modem from the
  1352.                   dialling directory are being processed properly.
  1353.  
  1354.     PREFIX 1..5 - These are the dialling prefixes which are sent prior to
  1355.                   the telephone number selected in the dialling directory.
  1356.                   For instance, in the above example, PREFIX 1 is set to
  1357.                   'ATDT' which will enable tone dialling. Five prefixes
  1358.                   are permitted in all, allowing you different
  1359.                   configurations for connecting to systems with a wide
  1360.                   variety of specifications, without having to reconfigure
  1361.                   PANTHER each time.
  1362.  
  1363.     BUSY STRINGS - These are the strings returned by your modem should a
  1364.                    connection fail to be made at all. They ought to be
  1365.                    entered in the above table separated by commas.
  1366.  
  1367.     PORT LOCKED? - If you specify 'Y' to PORT LOCKED? then your modem will
  1368.                    not renegotiate the baud rate returned by the incoming
  1369.                    connect string. If you specify 'N' then your modem will
  1370.                    be reinitialised to the actual connect speed. You ought
  1371.                    to select 'Y' to this option if your modem is either
  1372.                    working at high speed (ie, over or equal to 9600 baud),
  1373.                    is error correcting or supports MNP error correction.
  1374.                    Otherwise, select 'N'.
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 21
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.     CONNECT 300    - These are the strings that your modem returns on
  1394.     CONNECT 1200   making a successful connection. They may vary from
  1395.     CONNECT 2400   modem to modem, but generally ought to be similar to
  1396.     CONNECT 4800   those entered by the installation program. Notice that
  1397.     CONNECT 7200   the 'standard' connect string for 300 baud is just
  1398.     CONNECT 9600   'CONNECT'. Since every connect string is likely to
  1399.     CONNECT 12000  contain this word, care should be taken to ensure that
  1400.     CONNECT 14400  the 300 baud string is terminated with a return
  1401.     CONNECT 19200  character (either # or ^M) in order to prevent all
  1402.     CONNECT 38400  connections from being recognised as being at 300 baud.
  1403.     CONNECT 57600
  1404.  
  1405.     MERCURY PREFIX - If you are a subscriber to Mercury Communications
  1406.                      then you can force a Mercury connection by preceding
  1407.                      the telephone number entry in the dialling directory
  1408.                      with an 'M'. In order to connect with Mercury, you'll
  1409.                      have to let PANTHER know what your authorisation
  1410.                      number is. Enter it in this box. You'll also have to
  1411.                      enter the preceding code (which is 131 at the time of
  1412.                      writing) and maybe a separating comma (,) to pause
  1413.                      the modem prior to sending out your personal code.
  1414.  
  1415.     To edit an entry, move the highlight bar down to it and type in what
  1416.     you wish. If the first character you press is a letter or number key,
  1417.     then the entry will be erased and you can re-enter the whole string.
  1418.     If you don't wish to retain the entry then press the up or down arrow
  1419.     keys and the original string will reappear, otherwise, press [RETURN]
  1420.     to 'keep' your modifications to each string.
  1421.  
  1422.     Once you are satisfied with your entries, press F10 to keep them.
  1423.     Pressing ESCape aborts the editing procedure, although you will be
  1424.     asked to confirm that you want to abort.
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 22
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.     COLOURS
  1460.     -------
  1461.  
  1462.     You are free to change the colours in PANTHER to suit your tastes.,
  1463.     After all, you might not like our choice! The colour configuration
  1464.     menu looks like this;
  1465.  
  1466.   ┌─This is a menu──────────────────────┐          SELECT ITEM TO ALTER
  1467.   │      This is the header colour      │ ┌────────────────────────────────────┐
  1468.   │  F1   This is an unselected choice  │ │   A - Main Menu Foreground         │
  1469.   │  F2   This is a selected choice     │ │   B - Main Menu Background         │
  1470.   │  F3   This is an unselected choice  │ │   C - Main Menu Border             │
  1471.   │  F4   This is an unselected choice  │ │   D - Main Menu Emphasised         │
  1472.   │       This is emphasised text       │ │   E - Hot Key Menu Initial         │
  1473.   │            Hot Keys Menu            │ │   F - Hot Key Menu Text            │
  1474.   │  Field Prompt Field Input.........  │ │   G - Field Prompt Text            │
  1475.   └─────────────────────────────────────┘ │   H - Field Input Foreground       │
  1476.   ┌─This is a help screen───────────────┐ │   I - Field Input Background       │
  1477.   │    This is the help screen text     │ │   J - Main Menu Header Message     │
  1478.   │    This is a help screen message    │ │   K - Bar/Error Message Foreground │
  1479.   │  This is a help screen instruction  │ │   L - Bar/Error Message Background │
  1480.   └─────────────────────────────────────┘ │   M - Advisory Message Foreground  │
  1481.   ┌─This is a directory─────────────────┐ │   N - Advisory Message Background  │
  1482.   │  SCRIPTS      <DIR> 20:8:91 12:48p  │ │   O - Help Screen Foreground       │
  1483.   │  PANTHER.EXE  73546 20:9:91  5:23a  │ │   P - Help Screen Background       │
  1484.   │  PANTHER.CFG   1358 23:9:91  9:14p  │ │   Q - Directory Border Foreground  │
  1485.   │  PANTHER.SNP  13776 24:9:91  2:34a  │ │   R - Directory Border Background  │
  1486.   └─────────────────────────────────────┘ │   S - Style of Menu Borders        │
  1487.         This is an advisory message       └────────────────────────────────────┘
  1488.          This is an error message
  1489.  
  1490.        ESC Abort : F1 Help : F2 Restore : F3 Colour : F4 Mono : F10 Save
  1491.  
  1492.     The menu on the RIGHT controls which attributes to change. Selecting
  1493.     any but the last entry brings up a (coloured) list of colours for you
  1494.     to choose from. Select the colour you wish and the dummy menus on the
  1495.     LEFT will be updated to reflect that choice. The last 'Style of Menu
  1496.     Borders' menu selection will call up four different box styles for you
  1497.     to choose from.
  1498.  
  1499.     Pressing F2 will restore the altered colours to those which you
  1500.     started off with (just in case you get carried away!), F3 will reset
  1501.     the colours to the COLOUR default and F4 will reset them to the
  1502.     MONOCHROME defaults. F10 saves the colour set up and ESC aborts, with
  1503.     confirmation.
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 23
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.     PROTOCOLS
  1526.     ---------
  1527.  
  1528.     Selecting this option brings up the main protocol menu. Move the
  1529.     scroll bar up and down the menu using the arrow keys, space bar or
  1530.     mouse and either select the required protocol to edit using the return
  1531.     key or abort the process by pressing ESC. Selecting the entry at the
  1532.     end of the menu will append a new protocol definition to the end of
  1533.     the menu. You can have up to 15 protocol definitions at any one time
  1534.     (including the internal protocols which for obvious reasons aren't
  1535.     shown in the protocol edit menu!) which ought to be more than enough
  1536.     for most people!
  1537.  
  1538.                          ┌─────────────────────────┐
  1539.                          │   Protocol Edit Menu    │
  1540.                          │                         │
  1541.                          │  >X - Xmodem CheckSum   │
  1542.                          │   C - Xmodem - CRC      │
  1543.                          │   Y - Ymodem            │
  1544.                          │   Z - Zmodem            │
  1545.                          │   H - HyperProtocol     │
  1546.                          │   G - GSZ Zmodem        │
  1547.                          │   J - JModem            │
  1548.                          │   M - MPT (Puma)        │
  1549.                          │   NEW PROTOCOL ENTRY    │
  1550.                          │                         │
  1551.                          └─────────────────────────┘
  1552.  
  1553.     In the above example, lets assume you have selected Xmodem Checksum
  1554.     and wish to edit the settings for that external protocol. You will
  1555.     then be presented with the protocol configuration menu which looks
  1556.     like this;
  1557.  
  1558. ┌──────────────────────────────────────────────────────────────────────────────┐
  1559. │Hotkey          : X                                                           │
  1560. │Protocol Name   : Xmodem Checksum                                             │
  1561. │Upload Command  : xmod.com port *comport speed *baud sx *fname................│
  1562. │Download Command: xmod.com port *comport speed *baud rx *fname................│
  1563. └──────────────────────────────────────────────────────────────────────────────┘
  1564.  
  1565.     You can move about the fields using the arrow keys, mouse or return
  1566.     key. The meanings of each field are as follows;
  1567.  
  1568.     HotKey - This is the character which will appear on the left of the
  1569.              protocol menu when it is called up. (as in the example above)
  1570.              You can quickly select to use this protocol by simply
  1571.              pressing the hot key rather than moving the scroll bar about.
  1572.  
  1573.     Protocol Name - This is the name of the protocol (not necessarily the
  1574.                     name of the protocol file - it can be anything you
  1575.                     like) as it will appear in the dialling directory
  1576.                     information box.
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 24
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.     Upload/Download Command - These are the full DOS commands to start
  1592.                               uploading or downloading files using this
  1593.                               particular protocol. The command MUST start
  1594.                               with the file's name (just as if starting it
  1595.                               from DOS) and can then take any arguments it
  1596.                               requires. Note that the file name must
  1597.                               include the .EXE or .COM extension.
  1598.  
  1599.     The protocol menu will NOT allow you to save upload and download
  1600.     commands lines unless the actual protocol program exists within the
  1601.     protocol menu!
  1602.  
  1603.     In order to assist you in setting up the protocols menu, and to
  1604.     accommodate any configurational changes to PANTHER, there are four
  1605.     PANTHER system variables which you can include in the command line;
  1606.  
  1607.          *COMPORT - This returns the current serial port being used. For
  1608.                     example, if you are set up to use COM1 then *COMPORT
  1609.                     will return "1"
  1610.  
  1611.          *BAUD    - This returns the current baud rate that the connection
  1612.                     is at. If connected at 2400 baud then *BAUD will
  1613.                     return "2400".
  1614.  
  1615.        *LINESPEED - This will return the actual speed of the connection,
  1616.                     irrespective of the baud rate that the port is set at.
  1617.                     This may be useful in circumstances where a protocol
  1618.                     will return an accurate estimate of the transfer time
  1619.                     but where the port is set to a higher rate than the
  1620.                     connection speed.
  1621.  
  1622.          *FNAME   - This is the name of the file(s) you are uploading or
  1623.                     downloading.
  1624.  
  1625.          *PATH    - This is the path from which either files are being
  1626.                     uploaded from or downloaded into, depending upon
  1627.                     which (uploading or downloading) you are currently
  1628.                     doing.
  1629.  
  1630.     For further advice in setting up your protocols, refer to your
  1631.     protocol's documentation.
  1632.  
  1633.     One of the most popular file transfer protocol programs is Omen
  1634.     Technology's DSZ. As an example, here are the settings we recommend
  1635.     you use for Zmodem, Ymodem and Ymodem-g. (NB - your copy of DSZ may be
  1636.     called dsz.exe!)
  1637.  
  1638. ┌──────────────────────────────────────────────────────────────────────────────┐
  1639. │Hotkey          : Z                                                           │
  1640. │Protocol Name   : Zmodem.........                                             │
  1641. │Upload Command  : dsz.com port *comport speed *baud p sz *fname...............│
  1642. │Download Command: dsz.com port *comport speed *baud p rz -mr *path............│
  1643. └──────────────────────────────────────────────────────────────────────────────┘
  1644.  
  1645.  
  1646.  
  1647.  
  1648.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 25
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657. ┌──────────────────────────────────────────────────────────────────────────────┐
  1658. │Hotkey          : Y                                                           │
  1659. │Protocol Name   : Ymodem.........                                             │
  1660. │Upload Command  : dsz.com port *comport speed *baud sb *fname.................│
  1661. │Download Command: dsz.com port *comport speed *baud rb *path..................│
  1662. └──────────────────────────────────────────────────────────────────────────────┘
  1663. ┌──────────────────────────────────────────────────────────────────────────────┐
  1664. │Hotkey          : G                                                           │
  1665. │Protocol Name   : Ymodem-g.......                                             │
  1666. │Upload Command  : dsz.com port *comport speed *baud sb -k *fname..............│
  1667. │Download Command: dsz.com port *comport speed *baud rb -g *path...............│
  1668. └──────────────────────────────────────────────────────────────────────────────┘
  1669.  
  1670.  
  1671.     PATHS
  1672.     -----
  1673.  
  1674.     Select this option to set up the file paths to the various files which
  1675.     are required by PANTHER. A menu will appear in the centre of the
  1676.     screen showing your current file path settings.
  1677.  
  1678.      ┌─────────────────────┤ ENTER DIRECTORY PATHS ├─────────────────────┐
  1679.      │ PROGRAM PATH   C:\PANTHER\....................................... │
  1680.      │ UPLOAD PATH    C:\PANTHER\UPLOAD................................. │
  1681.      │ DOWNLOAD PATH  C:\PANTHER\DOWNLOAD............................... │
  1682.      │ PROTOCOL PATH  C:\PANTHER\PROTOCOL\.............................. │
  1683.      │ SCRIPT PATH    C:\PANTHER\SCRIPTS\............................... │
  1684.      └───────────────────┤ F10 TO ACCEPT, ESC ABORTS ├───────────────────┘
  1685.  
  1686.     Move between the fields using the arrow keys, return character or tab
  1687.     key. The paths ought to be as follows;
  1688.  
  1689.         PROGRAM PATH   - This is where PANTHER.EXE resides, along with
  1690.                          all its support files.
  1691.         UPLOAD PATH    - This is where files will uploaded from, by
  1692.                          default.
  1693.         DOWNLOAD PATH  - This is where files will downloaded into, by
  1694.                          default.
  1695.         PROTOCOL PATH  - This is where your external protocol programs
  1696.                          reside, along with any support files that they
  1697.                          require.
  1698.         SCRIPT PATH -    This is (guess what?) where your script files
  1699.                          are.
  1700.  
  1701.     If you leave the program path blank then it is assumed that
  1702.     PANTHER.EXE is in the current directory. Leaving any other field blank
  1703.     assumes that the file path lives directly 'off' the program path, in
  1704.     its 'default' name. The upload directory defaults to 'UPLOAD', the
  1705.     download directory defaults to 'DOWNLOAD', the protocols directory
  1706.     defaults to 'PROTOCOL' and the script file directory defaults to
  1707.     'SCRIPTS'.
  1708.  
  1709.     Once you have entered the names to your satisfaction, press F10 to
  1710.     keep them, otherwise press ESC to abort the process. (with
  1711.     confirmation)
  1712.  
  1713.  
  1714.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 26
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.     If any of the directories that you specify does not exist then PANTHER
  1725.     will create them accordingly, however, in the case of the protocol
  1726.     directory, ensure that the protocol programs themselves are physically
  1727.     in the directory before attempting to make any connection.
  1728.  
  1729.     If, when you press F10 to keep the settings, you have specified a
  1730.     non-existent program path (that is, if PANTHER cannot find its own EXE
  1731.     file in it!) then you will receive an error message and will be
  1732.     prompted to re-enter the program path name again.
  1733.  
  1734.  
  1735.     PROGRAM SETTINGS
  1736.     ----------------
  1737.  
  1738.     This menu sets up some of the 'miscellaneous' settings used by other
  1739.     aspects of the program, most notably your script files. Calling this
  1740.     option brings up the following menu;
  1741.  
  1742.                ┌──────────────────────────────────────────────┐
  1743.                │               PROGRAM SETTINGS               │
  1744.                │         Select Choice or ESC to Quit         │
  1745.                │                                              │
  1746.                │    >F1  Sound is ON                          │
  1747.                │     F2  Log file is ON                       │
  1748.                │     F3  Raw logging is OFF                   │
  1749.                │     F4  Buffer dumping is OFF                │
  1750.                │     F5  Automatic Zmodem transfer is ON      │
  1751.                │     F6  Users Name                           │
  1752.                │     F7  Auto Dialler Time Out                │
  1753.                │     F8  Define Mail Files                    │
  1754.                │     F9  Default Script Timeout               │
  1755.                │     F10 Exit                                 │
  1756.                │                                              │
  1757.                └──────────────────────────────────────────────┘
  1758.  
  1759.     Move the highlighted scroll bar with the arrow keys, mouse or space
  1760.     bar and select the option you wish by pressing return, pressing the
  1761.     associated function key or by clicking the mouse once. Each option has
  1762.     a slightly different usage.
  1763.  
  1764.     Sound Toggle - Selecting this option 'toggles' the usage of sound (on
  1765.                    connection to remote systems or on errors). The sound
  1766.                    can either be set permanently on or permanently off.
  1767.                    It can also be set to 'varying' which means that sound
  1768.                    depends upon the time of day. Specifically, this
  1769.                    setting enables sounds only between 9.00am and 5.00pm
  1770.                    and disables it at all other times. For example, in
  1771.                    the above illustration, if you were to press F1 then
  1772.                    the menu entry would change to 'Sound VARIES' and
  1773.                    pressing it again would make it 'Sound is OFF'.
  1774.                    Pressing it once again would change it back to 'Sound
  1775.                    is ON', and so on.
  1776.  
  1777.  
  1778.  
  1779.  
  1780.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 27
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.     Log File Toggle - Selecting this option 'toggles' the usage of a
  1790.                       detailed running log file of all connections made.
  1791.                       (PANTHER.LOG, found in the main program directory)
  1792.                       For example, in the above illustration, if you were
  1793.                       to press F2 then the menu entry would change to 'Log
  1794.                       file is OFF'. Pressing it once again would change it
  1795.                       back to 'Log file is ON', and so on.
  1796.  
  1797.     Raw Logging Toggle - Like the log file toggle, this just selects
  1798.                          whether or not sessions are 'raw logged'. Raw
  1799.                          logging simply captures *all* incoming data from
  1800.                          the port and saves it off to a file called either
  1801.                          RAWLOG.TXT (for Teletype), RAWLOG.ANS (for ANSI),
  1802.                          RAWLOG.AVT (for Avatar), or RAWLOG.V52 (for VT52)
  1803.                          and which can be viewed through the raw log viewer
  1804.                          from the main menu.
  1805.  
  1806.     Auto Zmodem Transfer - This toggles whether or not Zmodem downloads
  1807.                            are triggered as soon as PANTHER detects a
  1808.                            valid Zmodem string being sent to it from the
  1809.                            remote system. Doing so will save you having to
  1810.                            hit the PageDn key. I mean, how lazy can you
  1811.                            get!
  1812.  
  1813.     Users Name - This one will simply ask you for your name! This is
  1814.                  needed in order to allow script files to use the script
  1815.                  variables *NAME, *FIRST and *LAST properly.
  1816.  
  1817.     Auto Dialler Time Out - You will be prompted to enter the time (in
  1818.                             minutes) that the Auto Dialler will time out
  1819.                             after if no data is received from the remote
  1820.                             system, usually a sign that your script file
  1821.                             has gone awry or that the remote system has
  1822.                             hung. The value entered must be between 1 and
  1823.                             99, though anyone selecting anything like 99
  1824.                             minutes for an Auto Dialler time out needs to
  1825.                             have a good talking to!
  1826.  
  1827.     Define Mail Files - One of the problems facing users of all kinds of
  1828.                         PC Communications is the use of electronic mail.
  1829.                         Mail can be read offline (thereby saving your
  1830.                         phone bills) by downloading 'mailbags', replying
  1831.                         to them using an offline mail editor, then
  1832.                         uploading your replies to the remote system the
  1833.                         next time you log on. The theory is that you then
  1834.                         delete your replies and then edit the replies to
  1835.                         the mailbag you have just downloaded. Great, eh?
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 28
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.                         Unfortunately, there is a problem; what if you
  1856.                         forget to delete the uploaded replies from your
  1857.                         upload directory. You will probably at some time
  1858.                         forget what you have done and upload the same
  1859.                         replies twice. Not all host systems have
  1860.                         intelligent enough mail routines to detect whether
  1861.                         you've already uploaded replies and will gaily
  1862.                         sort them as if they were brand new, thereby
  1863.                         duplicating all your messages, making you look a
  1864.                         complete fool and incurring the wrath of the
  1865.                         System Operator whose hard disk has to hold all
  1866.                         this duplicated stuff. Okay, so what if it's only
  1867.                         one or two messages? But what if it were a dozen?
  1868.                         Or six hundred? More problems...but PANTHER comes
  1869.                         to the rescue!
  1870.  
  1871.                         If you select this option you will be presented
  1872.                         with the following line;
  1873.  
  1874.           Enter file masks : *.REP FORTH*.*......................
  1875.  
  1876.                         You can then enter up to TEN file 'masks' (that
  1877.                         is, filenames using the DOS wildcards '*' and '?',
  1878.                         if you wish) which specify the file names of all
  1879.                         your mailbag replies. The installation program
  1880.                         puts in the above entries, where for example
  1881.                         '*.REP' is the name of the reply mailbag generated
  1882.                         by QWK compatible offline mailers. If you upload a
  1883.                         file which falls into any of the (maximum of) ten
  1884.                         file masks you specify, then you will receive a
  1885.                         prompt asking you if you wish to delete the
  1886.                         mailbag. Simply tell PANTHER that you wish the
  1887.                         file to be deleted, and wave bye bye to
  1888.                         duplicated, mail uploads forever more!
  1889.  
  1890.                         Well...almost forever more. You will only receive
  1891.                         the file deletion request IF YOU RECEIVE BACK A
  1892.                         ZERO DOS 'ERRORLEVEL' FROM THE PROTOCOL PROGRAM
  1893.                         DOING THE UPLOAD! If the protocol program returns
  1894.                         anything other that a zero ERRORLEVEL then it
  1895.                         generally means something went wrong somewhere
  1896.                         along the line and the upload never took place.
  1897.                         Fair enough? Almost. However, some protocol
  1898.                         programs return non-zero ERRORLEVELs even when
  1899.                         everything went fine! So you will *probably* not
  1900.                         ever have duplicated mailbags again!
  1901.  
  1902.     Default Script Timeout - This will prompt you for the time (in
  1903.                              seconds) that PANTHER will wait after
  1904.                              waiting for a script file prompt specified by
  1905.                              a script RECEIVE command. That is, if
  1906.                              PANTHER is has got to this point in a script
  1907.                              file...
  1908.  
  1909.                                      RECEIVE "This is a prompt!"
  1910.  
  1911.  
  1912.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 29
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.                              ...then it will allow a certain length of
  1923.                              time to receive this prompt before timing the
  1924.                              script file out (and aborting it and, if you
  1925.                              are using it, dropping the carrier in Auto
  1926.                              Dialler Mode). That length of time is the
  1927.                              default script timeout. You can enter
  1928.                              anything you like between 1 (which is
  1929.                              probably just a tad too fast!) and 9999
  1930.                              seconds.
  1931.  
  1932.     Selecting EXIT from the main menus presents you with confirmation as
  1933.     to whether you wish to keep any of the changes you have made. You will
  1934.     then be taken back to the main configuration menu.
  1935.  
  1936.  
  1937.     DIRECTORY DEFAULTS
  1938.     ------------------
  1939.  
  1940.     This menu will ask you for the default settings for your dialling
  1941.     directory entries. When you add a new dialling directory entry, it
  1942.     will be pre-filled out with the settings read from the directory
  1943.     defaults, thereby saving you having to type them all in, although you
  1944.     can obviously change them if you wish to.
  1945.  
  1946.     These are also the default values used to initialise the port when in
  1947.     PANTHER's Terminal Mode, although they can be overridden by issuing
  1948.     other commands from the terminal itself.
  1949.  
  1950.     The default entry table looks like this;
  1951.  
  1952.  
  1953.              ┌───────┤ ENTER DEFAULT DIRECTORY SETTINGS ├────────┐
  1954.              │                                                   │
  1955.              │         BAUD             38400                    │
  1956.              │         PARITY           None                     │
  1957.              │         DATA BITS        8                        │
  1958.              │         STOP BITS        1                        │
  1959.              │         HANDSHAKING      RTS/CTS                  │
  1960.              │         PREFIX           1                        │
  1961.              │         TERMINAL         ANSI                     │
  1962.              │         PROTOCOL         (I) Zmodem               │
  1963.              │         DIAL TIME        99                       │
  1964.              │         LOCAL ECHO       NO                       │
  1965.              │         LINE FEEDS       NO                       │
  1966.              │         DEST BS          YES                      │
  1967.              │         IEMSI            NONE                     │
  1968.              │                                                   │
  1969.              └──────────────────┤ ESC TO QUIT ├──────────────────┘
  1970.  
  1971.    Enter baud : 300 1200 2400 4800 7200 9600 12000 14400 19200 38400 57600
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 30
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.     The current position is highlighted and the valid choices are at the
  1988.     foot of the screen. To change each setting, use the home, end, left
  1989.     and right arrow keys to move the highlight block on the lower (strip)
  1990.     menu and press return on the entry you wish to select. If you want to
  1991.     move to another entry in the upper (vertical) menu then use the up and
  1992.     down arrow keys until you reach the point you are after. Most
  1993.     selections are presented as either multiple choice (as in the BAUD
  1994.     example above) or as Yes/No choices (for example, in the LOCAL ECHO)
  1995.     entry.
  1996.  
  1997.     If you wish to alter the default protocol to be used then select YES
  1998.     from the 'Change Protocol? (Y/N)' prompt and you will be presented
  1999.     with the protocol menu, allowing you to select the default protocol
  2000.     from all those installed into PANTHER.
  2001.  
  2002.     For explicit descriptions of the meanings of all these fields, please
  2003.     consult the documentation regarding the dialling directory itself.
  2004.  
  2005.  
  2006.     EDIT IEMSI SESSION PACKETS
  2007.     --------------------------
  2008.  
  2009.     Couched in its simplest terms, IEMSI offers you the opportunity of
  2010.     logging onto some BBS systems (like RemoteAccess) without having to go
  2011.     through several initial screens. By logging on with an IEMSI session
  2012.     enabled for these systems your log-on will be *very* swift and will
  2013.     take you straight onto the system's 'front door' faster than a cat run
  2014.     from a vacuum cleaner.
  2015.  
  2016.     When you initially start the IEMSI editor you will initially be
  2017.     presented with a menu of ten possible IEMSI packets to edit. Select
  2018.     which packet you wish to edit by moving the highlit bar with the arrow
  2019.     keys and press return when you've highlighted the appropriate packet.
  2020.     If that entry corresponds to a new packet the menu title for that
  2021.     session packet will be 'UNDEFINED'.
  2022.  
  2023.     On opening a packet to edit you will be presented with PANTHER's
  2024.     internal IEMSI editor which looks like this;
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 31
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.      ┌─────────────────────┤ EDIT IEMSI SETTINGS ├─────────────────────┐
  2054.      │                                                                 │
  2055.      │ TITLE       ....................                                │
  2056.      │ NAME        ..................................................  │
  2057.      │ ALIAS       ..................................................  │
  2058.      │ PASSWORD    ...............                                     │
  2059.      │ LOCATION    ..................................................  │
  2060.      │ DATA PHONE  ...............                                     │
  2061.      │ VOICE PHONE ...............                                     │
  2062.      │                                                                 │
  2063.      │ SHOW NEWS BULLETINS? N        ENABLE SCREEN CLEARING? N         │
  2064.      │ CHECK FOR NEW MAIL?  N        ALLOW INTER-NODE CHAT?  N         │
  2065.      │ CHECK FOR NEW FILES? N        PAGE PAUSING?           N         │
  2066.      │ USE HOT KEYS?        N        USE FULL SCREEN EDITOR? N         │
  2067.      │                                                                 │
  2068.      │            This is the title of this IEMSI session              │
  2069.      │                                                                 │
  2070.      └──────────────────┤ F10 TO SAVE, ESC TO QUIT ├───────────────────┘
  2071.  
  2072.     The upper fields in the editor relate to your personal details for the
  2073.     remote system and the lower entries correspond to options which you
  2074.     can enable or disable according to your preference. Specifically, each
  2075.     of the fields mean the following;
  2076.  
  2077.     TITLE - This is the packet title as it will appear in the preceding
  2078.             menu and in the main dialling directory. This is only used
  2079.             internally by PANTHER and can be anything you like, really,
  2080.             although it may be better to make the title meaningful to
  2081.             assist in retrieving it in the future.
  2082.  
  2083.     NAME - This is your real name. NOTE: This must be *exactly* as you
  2084.            entered it originally on the remote system's configuration. You
  2085.            can enter the PANTHER internal variable *NAME here if it's
  2086.            appropriate. (ie, if it matches the name held by the remote
  2087.            system)
  2088.  
  2089.     ALIAS - If the system allows aliases enter an alias here if you like,
  2090.             otherwise leave it blank.
  2091.  
  2092.     PASSWORD - This is your log-in password. Again, you can use the
  2093.                internal PANTHER variable *PASSWORD here.
  2094.  
  2095.     LOCATION - This is your actual location, usually the name of your
  2096.                town.
  2097.  
  2098.     DATA PHONE  - These are merely notes of your telephone numbers for
  2099.     VOICE PHONE   voice and modem lines.
  2100.  
  2101.     The following are the 'options' selections and are selected only by
  2102.     entering Y or N in the box. Entering Y enables the option and N
  2103.     disables it.
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 32
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.     SHOW NEWS BULLETINS? - Do you want to be shown the local news
  2120.                            bulletins on logging on? (They can contain
  2121.                            useful information which you might need to know
  2122.                            for the current session)
  2123.  
  2124.     CHECK FOR NEW MAIL? - Do you want the system to run a quick check on
  2125.                           logging on to see if you have any mail waiting
  2126.                           for you? (If you are performing an automated
  2127.                           mail run then you might not want to bother with
  2128.                           this option)
  2129.  
  2130.     CHECK FOR NEW FILES? - Ditto as above except for files. (This can be a
  2131.                            great one to disable if you are dealing with a
  2132.                            large system that might take ages to search
  2133.                            over all its files areas)
  2134.  
  2135.     USE HOT KEYS? - Do you want single keystrokes to be used in menus and
  2136.                     so on or do you prefer to disable this and stick with
  2137.                     pressing return after each keystroke?
  2138.  
  2139.     ENABLE SCREEN CLEARING? - Do you want the remote system to send
  2140.                               screen clearing codes? (These are usually
  2141.                               ASCII character 12 symbols which PANTHER is
  2142.                               designed to handle)
  2143.  
  2144.     ALLOW INTER-NODE CHAT? - If this is a multi-node system then enabling
  2145.                              this option allows other users on other nodes
  2146.                              to page you and chat with you on line. (If you
  2147.                              want this then fair enough...but don't say we
  2148.                              didn't warn you)
  2149.  
  2150.     PAGE PAUSING? - When writing long lists of items to the screen, do you
  2151.                     want the remote system to pause after each pageful?
  2152.                     (Unless you are in possession of a lightning speed
  2153.                     photographic memory its usually helpful to enable this
  2154.                     option)
  2155.  
  2156.     USE FULL SCREEN EDITOR? - Do you want to use an editor that allows you
  2157.                               to edit text anywhere on the screen and
  2158.                               scroll to various parts of your document...or
  2159.                               do you want something else like a line editor
  2160.                               that makes EDLIN look like Wordperfect. (I'd
  2161.                               enable this if I were you)
  2162.  
  2163.     Once you're happy with your set up then press F10 and your selections
  2164.     will be saved. If you wish to abandon your choices then press escape,
  2165.     answer 'Y' to confirm that you want to abandon the editor and you will
  2166.     be returned to the original IEMSI menu. Pressing escape from this menu
  2167.     takes you back to the main configuration menu again.
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 33
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.     SAVE CONFIGURATION
  2186.     ------------------
  2187.  
  2188.     Once you have made all the amendments you wish to PANTHER's
  2189.     configuration then you are free to carry on and use them. However,
  2190.     unless you explicitly SAVE the configuration then the changes you have
  2191.     made will be lost when you quit the program. To make the changes
  2192.     permanent, select Save Configuration from the menu and the
  2193.     configuration file PANTHER.CFG will be rewritten to reflect your
  2194.     changes. This way, all your changes will be preserved the next time
  2195.     you start up PANTHER.
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 34
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.     RUNNING PANTHER
  2252.     ---------------
  2253.  
  2254.     When you initially start up PANTHER, two important checks are made.
  2255.  
  2256.     First, PANTHER checks to see whether or not it is already running. It
  2257.     does this by noting the presence or absence of a file called
  2258.     PANTHER.RUN in the main program directory. This file is written out
  2259.     when you start up PANTHER and is deleted when you quit from it. It's
  2260.     purpose is twofold; to stop you running PANTHER twice from within a
  2261.     multitasking system and to stop you from shelling out to DOS from
  2262.     within PANTHER and running it again.
  2263.  
  2264.     If PANTHER finds that the PANTHER.RUN file does not exist then it will
  2265.     write one out (to signify that PANTHER is now running) and proceed as
  2266.     normal. If however it finds that PANTHER.RUN already exists then it
  2267.     will flash an error message on the screen thus;
  2268.  
  2269.              ┌─────────────────────────────────────────────────┐
  2270.              │ PANTHER IS ALREADY RUNNING! RUN IT AGAIN? (Y/N) │
  2271.              └─────────────────────────────────────────────────┘
  2272.  
  2273.     If you press 'N' then PANTHER will not start but will instead return
  2274.     you to the operating system. If, on the other hand you *do* wish to
  2275.     run PANTHER then press 'Y' and it will start up. There are a couple of
  2276.     instances where you may want to run PANTHER, even though you have
  2277.     received this message; you may have rebooted your machine whilst
  2278.     PANTHER was running, thereby not letting it clear up its files
  2279.     properly and leaving the PANTHER.RUN file where it was created.
  2280.     Similarly, if you are using a multitasking system then you may have
  2281.     closed down the particular session instead of quitting from PANTHER
  2282.     via its menus.
  2283.  
  2284.     The second check PANTHER makes is to see whether or not a carrier
  2285.     signal is detected on your selected serial port. If there is a carrier
  2286.     signal then it might mean that your modem is either wrongly configured
  2287.     for use with PANTHER or else it may also be that the modem has an
  2288.     artificial carrier signal set permanently high. If the former then it
  2289.     will simply be a matter of reconfiguring the modem. If the latter then
  2290.     it's unlikely you can use PANTHER at all with any degree of
  2291.     reliability.
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 35
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.     If PANTHER finds a carrier on your selected port then the following
  2318.     error message will appear on the screen (the actual port number will
  2319.     vary, depending on your selected port)
  2320.  
  2321.     ┌──────────┤ WARNING - CARRIER DETECTED ON SERIAL PORT! ├───────────┐
  2322.     │                                                                   │
  2323.     │   PANTHER has detected a carrier signal on your selected serial   │
  2324.     │  port COM1. As this is the case, it is highly unlikely that this  │
  2325.     │   software will function as you expect since it relies on the     │
  2326.     │    changing state of a carrier signal to successfully detect a    │
  2327.     │    connection to a remote service. Furthermore, it may present    │
  2328.     │   serious problems when using PANTHER in terminal mode and may    │
  2329.     │         prevent you from quitting from it successfully.           │
  2330.     │                                                                   │
  2331.     │                  DO YOU WANT TO CONTINUE? (Y/N)                   │
  2332.     └───────────────────────────────────────────────────────────────────┘
  2333.  
  2334.     If you elect to continue then be warned you may not be able to quit
  2335.     from terminal mode properly since that depends upon the your modem
  2336.     returning a low carrier signal. To remind you, a message saying
  2337.  
  2338.             WARNING - CARRIER SIGNAL DETECTED ON SERIAL PORT COM1!
  2339.  
  2340.     appears on your main PANTHER menu. If you elect *not* to continue then
  2341.     PANTHER will simply abort altogether.
  2342.  
  2343.     With regard to the last check, it is possible (although unlikely) that
  2344.     your modem will function correctly, even thought PANTHER reports the
  2345.     problem. To stop PANTHER from displaying this error message every time
  2346.     you start it up (and it was designed to be irritating!) you can use
  2347.     the /NOCARRIERCHECK command line switch. See the section on command
  2348.     line switches for further details on this option.
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 36
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.     THE DIALLING DIRECTORY
  2384.     ----------------------
  2385.  
  2386.     The PANTHER dialling directory has been designed to be both easy to
  2387.     use and informative.
  2388.  
  2389.     Dialling directories are saved using the file extension PHN. By
  2390.     default, when starting up PANTHER the dialling directory PANTHER.PHN
  2391.     is loaded, although this can be over-ridden by using the DIR= command
  2392.     line directive to load another directory.
  2393.  
  2394.     Once you have installed PANTHER onto your system a sample dialling
  2395.     directory is created which contains the dialling details for four
  2396.     popular bulletin board systems. This is how the dialling directory may
  2397.     look, depending upon the choices you made in the installation program;
  2398.  
  2399. ┌──────────────────────┤ Dialling Directory PANTHER ├──────────────────────────┐
  2400. │     Name of Remote System          Telephone Number     Baud   Port  Script  │
  2401. ├────┬──────────────────────────────┬────────────────────┬──────┬─────┬────────┤
  2402. │   1│ALMAC BBS                     │0324 665371         │2400  │8-N-1│ALMAC   │
  2403. │   2│FORTH VIEW BBS                │031 660 6680        │2400  │8-N-1│PC-BOARD│
  2404. │   3│BLUE LABEL BBS                │0224 827166         │2400  │8-N-1│BLUELBL │
  2405. │   4│PISTON POPPER BBS             │0424 853361         │2400  │8-N-1│PISTON  │
  2406. │   5│MISSION IMPOSSIBLE            │0602 654329         │2400  │8-N-1│MISSPOSS│
  2407. │    │                              │                    │      │     │        │
  2408. │    │                              │                    │      │     │        │
  2409. │    │                              │                    │      │     │        │
  2410. │    │                              │                    │      │     │        │
  2411. │    │                              │                    │      │     │        │
  2412. │    │                              │                    │      │     │        │
  2413. ├────┴──────────────────────────────┴────────────────────┴──────┴─────┴────────┤
  2414. │ System Name  ALMAC BBS                          Number Of Calls 71           │
  2415. │ Last On 04:51 18/01/1993      Prefix # 3        Dialling Time 99 seconds     │
  2416. │ Handshaking RTS/CTS           Terminal ANSI     Protocol HyperProtocol       │
  2417. │ Total Time Spent On Line  00:57:43      IEMSI Session NONE                   │
  2418. ├──────────────────────────────────────────────────────────────────────────────┤
  2419. │  ESC to quit                                                    F1 for help  │
  2420. └──────────────────────────────────────────────────────────────────────────────┘
  2421.  
  2422.     The upper section of the directory display consists of a window with a
  2423.     highlighted entry, indicating the current selection. If there are more
  2424.     than ten entries in each directory then these can be shown by moving
  2425.     the highlight bar. The highlight bar can be moved using the PageUp,
  2426.     PageDn, Home, End and arrow keys as well as by using a mouse. The
  2427.     lower panel shows more detailed information about the settings for the
  2428.     currently selected entry.
  2429.  
  2430.     Several connections can be made in succession by selecting the current
  2431.     entry by using the space bar. Once selected in this manner a marker
  2432.     will appear on the right hand side of the dialling entry indicating
  2433.     that this entry has been selected. To deselect an entry, move the
  2434.     highlight bar back to it and press the space bar again. You can select
  2435.     any number of entries in this manner, causing a queue of entries to be
  2436.     connected at any one time.
  2437.  
  2438.  
  2439.  
  2440.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 37
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.     The upper window shows the name and telephone number of each entry in
  2450.     the directory followed by the baud rate, summarised port settings and
  2451.     the name of any script file associated with that particular entry.
  2452.  
  2453.     The lower panel shows the number of calls made, the time and date you
  2454.     were last connected to this system, the required dialling prefix, the
  2455.     dialling time for each attempt to connect to the current entry, the
  2456.     handshaking protocol, the kind of display that is used, the default
  2457.     file transfer protocol, the total length of all successful connections
  2458.     made and whether or not an IEMSI session packet is to be used during
  2459.     connection.
  2460.  
  2461.     To quit from the dialling directory press escape. For a full list of
  2462.     commands press F1 and you will see all the possible commands that you
  2463.     can issue by pressing the bracketed letter of each. We will deal with
  2464.     these one at a time;
  2465.  
  2466.     Dial
  2467.  
  2468.     This causes PANTHER to start dialling (surprisingly enough!) the
  2469.     currently selected entry. On doing so, the dialling directory will be
  2470.     replaced with the dialling screen which will show all command strings
  2471.     being sent to the modem. A status line will appear at the bottom of
  2472.     the screen showing the remaining dial time for each connection at the
  2473.     lower right corner. More about dialling and being on line in a
  2474.     minute... You can also start dialling by pressing the return key when
  2475.     the scroll bar is over the entry for the remote system you wish to
  2476.     contact. Incidentally, if you attempt to dial a blank entry which has
  2477.     just been created with the Insert or New commands then you will be
  2478.     forced to edit that entry instead. But more about editing dialling
  2479.     directories in a minute as well..
  2480.  
  2481.     Insert
  2482.  
  2483.     This will insert a blank entry into the dialling directory at the
  2484.     point currently highlighted by the scroll bar. You can also select
  2485.     this with the insert key.
  2486.  
  2487.     Create
  2488.  
  2489.     A new blank dialling directory will be created on your disk.
  2490.  
  2491.     Edit
  2492.  
  2493.     This will cause you to edit the dialling directory entry currently
  2494.     highlighted. We'll cover this in detail in a minute!
  2495.  
  2496.     Copy
  2497.  
  2498.     A new entry will be inserted immediately after the current entry and
  2499.     the current highlighted entry will be copied into the new entry. This
  2500.     may be useful where you wish to associate numerous script files with
  2501.     one remote system.
  2502.  
  2503.  
  2504.  
  2505.  
  2506.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 38
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.     Manual
  2516.  
  2517.     If you select Manual dialling, a box will appear at the bottom of the
  2518.     screen asking you for a telephone number. Simply enter the telephone
  2519.     number into the box and press return. The number will then be dialled
  2520.     using the defaults as set up in the Directory Defaults section of the
  2521.     configuration section.
  2522.  
  2523.     Remove
  2524.  
  2525.     This will delete the entry currently highlighted by the scroll bar.
  2526.     You can also select this by pressing the delete key.
  2527.  
  2528.     Sort
  2529.  
  2530.     This will sort the dialling directory along one of three criteria; it
  2531.     can be sorted according to the names of the remote systems, the total
  2532.     time spent on line (with the longest first) or by the number of calls
  2533.     made to each system (again with the highest first). Alternatively, if
  2534.     you do not wish to sort the directory, select 'QUIT' or press escape.
  2535.  
  2536.     Print
  2537.  
  2538.     Unbelievable as it may seem, this option actually prints the dialling
  2539.     directory out onto paper. The print out will show each entry with all
  2540.     of its settings, together with a note of the total number of calls you
  2541.     have made and the total length of time you have been on line. Scary.
  2542.     Please ensure you have a printer attached to your computer first! If
  2543.     you don't, or if you have some other problem with the printer, then an
  2544.     error message will occur advising you that the printer is either out
  2545.     of paper, off line or busy, depending upon the circumstances.
  2546.  
  2547.     New
  2548.  
  2549.     This will append a blank entry to the end of the dialling directory.
  2550.  
  2551.     Load
  2552.  
  2553.     Selecting this option will bring up a scrolling directory box showing
  2554.     all the dialling directories on your disk. Simply move the highlight
  2555.     bar to the directory that you want to load and press return. The
  2556.     selected directory will then be loaded up.
  2557.  
  2558.     Zero
  2559.  
  2560.     This will reset the number of calls and total time on line back to
  2561.     zero. If you select this option you will be greeted a prompt saying;
  2562.  
  2563.           'Zero the highlighted entry, all entries or none? (H/A/N)'
  2564.  
  2565.     Pressing 'H' will cause the entry currently highlighted to be zeroed.
  2566.     Pressing 'A' will zero all entries in the dialling directory. Pressing
  2567.     'N' is effectively the same as pressing escape.
  2568.  
  2569.  
  2570.  
  2571.  
  2572.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 39
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.     Tag
  2582.  
  2583.     This will 'tag' the currently highlighted entry. A small marker will
  2584.     appear in the left hand margin showing that the entry has been tagged.
  2585.     By tagging entries in this manner you can cause PANTHER to dial out to
  2586.     multiple systems in a queue, one after the other. You can also tag
  2587.     entries with the space bar.
  2588.  
  2589.     Untag
  2590.  
  2591.     Selecting this option will untag all tagged entries in the current
  2592.     directory.
  2593.  
  2594.     Move
  2595.  
  2596.     This allows you to manually sort your dialling directories by moving
  2597.     individual entries from one position to another. Highlight the entry
  2598.     you wish to move and then scroll the highlight bar to the target
  2599.     position and press enter to move the entry to that position. If you
  2600.     wish to abort the move process halfway through then (a) press escape
  2601.     and (b) make your bloody mind up next time.
  2602.  
  2603.     There are also a few other keystrokes available. These are;
  2604.  
  2605.     ALT-D Shell to DOS temporarily. The screen will clear and you will find
  2606.           yourself in a DOS session. To remind you that you are running
  2607.           PANTHER the DOS prompt will change from your normal prompt into
  2608.           '[PANTHER] $p$g'. To re-enter PANTHER, type EXIT <return> at the
  2609.           DOS prompt and you will find yourself at exactly the same
  2610.           position you were in before you shelled out.
  2611.  
  2612.     ALT-V Allows you to view the internal scrollback buffer.
  2613.  
  2614.     ALT-Y Allows you to edit the internal filelist
  2615.  
  2616.     ALT-0 Allows you to toggle the script overwrite mode. Basically, if
  2617.           this is activated then PANTHER will forcibly learn any script
  2618.           you tell it, even if it exists., therefore obliterating the
  2619.           existing script completely. Use with caution! To remind you that
  2620.           the script overwrite mode is active, a flashing warning appears
  2621.           in the dialling directory saying 'Script overwrite mode is
  2622.           active!'. See the section on script files for more information on
  2623.           this uniquely destructive..er..I mean highly useful feature.
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 40
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.     EDITING THE DIALLING DIRECTORY
  2648.     ------------------------------
  2649.  
  2650.     If you select 'Edit' from the main dialling directory, a window will
  2651.     pop up on the screen showing the settings for the current entry. The
  2652.     window looks like this;
  2653.  
  2654.           ┌───────────┤ EDIT CURRENT DIRECTORY ENTRY ├────────────┐
  2655.           │                                                       │
  2656.           │   Name            ALMAC BBS                           │
  2657.           │   Number          0324 665371                         │
  2658.           │   Password        ***************                     │
  2659.           │   Script File     ALMAC                               │
  2660.           │   Dial Time       60                                  │
  2661.           │   Baud            2400                                │
  2662.           │   Parity          None                                │
  2663.           │   Stop Bits       1                                   │
  2664.           │   Data Bits       8                                   │
  2665.           │   Handshaking     XONXOFF                             │
  2666.           │   Prefix          1                                   │
  2667.           │   Terminal        ANSI                                │
  2668.           │   Protocol        (I) Zmodem                          │
  2669.           │   Local Echo      NO                                  │
  2670.           │   Add Line Feed   NO                                  │
  2671.           │   Dest. Backspace YES                                 │
  2672.           │   IEMSI           NONE                                │
  2673.           │                                                       │
  2674.           └────────────────────┤ ESC TO QUIT ├────────────────────┘
  2675.  
  2676.     There will be a highlight bar over the 'NAME' field and a box on the
  2677.     bottom line inviting you to enter the name of the current entry. you
  2678.     can move the highlight bar up and down the window with the arrow keys.
  2679.     As you do so, the prompt at the foot of the screen will change
  2680.     according to what field you are currently highlighting.
  2681.  
  2682.     The fields are either edited using a text entry line, as in the 'NAME'
  2683.     field, or through a multiple choice selection menu. If you wish to
  2684.     record your amendment, press return, otherwise press an arrow key to
  2685.     move to a new field and leave the old field unaltered. We shall deal
  2686.     with each of the fields separately;
  2687.  
  2688.     Name
  2689.  
  2690.     All you have to enter here is the name of the remote system. You are
  2691.     allowed up to thirty characters for this field.
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 41
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.     Number
  2714.  
  2715.     Here you have to enter here is the telephone number for the remote
  2716.     system. You are allowed up to twenty characters for this field. If you
  2717.     are a subscriber to Mercury Communications then prefixing the number
  2718.     with the letter 'M' will cause the connection to be made via Mercury,
  2719.     assuming that you have defined your Mercury code in the configuration,
  2720.     that is! Please note that it is *not* recommended you make local calls
  2721.     via Mercury. At the time of writing, routing local calls through
  2722.     Mercury costs about 2½ times as much as British Telecom.
  2723.  
  2724.     Password
  2725.  
  2726.     Enter the password you use on the remote system, if any. This will be
  2727.     used to replace the *PASSWORD variable in script files. You are
  2728.     allowed up to fifteen characters for this field. Note that the
  2729.     password won't actually show up in the edit panel.
  2730.  
  2731.     Script File
  2732.  
  2733.     Enter the name of the associated script file, if any, you wish run
  2734.     when calling the remote system. A couple of points to make here;
  2735.     although script files all have the file extension '.SPT' do NOT enter
  2736.     this, only the first portion of the file name. Also, if you enter the
  2737.     name of a script file which does not exist in the script file
  2738.     directory (as defined in the configuration menu) then PANTHER will
  2739.     assume that you wish to learn it and will create it for you the first
  2740.     time you connect to the remote system. See the section of this manual
  2741.     on script files for more information. You are allowed eight characters
  2742.     for the script file name.
  2743.  
  2744.     Dial Time
  2745.  
  2746.     This is the length of time in seconds that PANTHER will take between
  2747.     dialling the telephone number for the remote system and hanging up to
  2748.     try again. Enter a value between 1 and 255. Note that you can manually
  2749.     intervene when dialling out. If you find that your dial time is too
  2750.     short, pressing the up and down arrow keys will temporarily increase
  2751.     or decrease the dialling time respectively. But more about that later
  2752.     as well.....!
  2753.  
  2754.     Baud
  2755.  
  2756.     This is the speed at which the remote system operates. If you have
  2757.     elected to operate with a locked port (in the modem strings
  2758.     configuration section) then this should be set to the highest speed at
  2759.     which the RS232 port on your computer can operate reliably. You will
  2760.     be presented with a multiple choice menu along the foot of the screen.
  2761.     Move the highlighted box along the line with the left and right arrow
  2762.     keys until you reach the required baud rate and then press return to
  2763.     select it.
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 42
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.     Parity
  2780.  
  2781.     Enter the required parity setting for the remote system. You will be
  2782.     presented again with a multiple choice menu like this;
  2783.  
  2784.               Enter parity :  Space   Odd   Mark   Even   None
  2785.  
  2786.     Move the highlighted box along the line with the left and right arrow
  2787.     keys until you reach the required parity setting and then press return
  2788.     to select it.
  2789.  
  2790.     Stop Bits
  2791.  
  2792.     Enter the required number of stop bits for the incoming data from the
  2793.     remote system. Again, you will be presented with a multiple choice
  2794.     menu like this;
  2795.  
  2796.                           Enter stop bits :  1   2
  2797.  
  2798.     Move the highlighted box along the line with the left and right arrow
  2799.     keys until you reach the required number of stop bits and then press
  2800.     return to select it.
  2801.  
  2802.     Data Bits
  2803.  
  2804.     Enter the required number of data bits for the incoming data from the
  2805.     remote system. Again, you will be presented with a multiple choice
  2806.     menu like this;
  2807.  
  2808.                           Enter data bits :  7   8
  2809.  
  2810.     Move the highlighted box along the line with the left and right arrow
  2811.     keys until you reach the required number of data bits and then press
  2812.     return to select it.
  2813.  
  2814.     Handshaking
  2815.  
  2816.     Enter the handshaking (or flow control) you require. You can select
  2817.     from one either None, Rts/Cts (also known as hardware handshaking) or
  2818.     Xon/Xoff (also known as software handshaking). Hardware handshaking is
  2819.     generally reserved for high speed modems and locked RS232 ports.
  2820.  
  2821.     Prefix
  2822.  
  2823.     Select which dialling prefix is to be used with the remote system.
  2824.     These are the strings to be sent to your modem immediately prior to
  2825.     the telephone number. As a reminder of what prefixes you have set up,
  2826.     a further small window will appear on the screen containing each of
  2827.     your current prefixes. Your prefixes will normally (if you have a
  2828.     Hayes compatible modem) start with 'AT' and terminate with either 'DT'
  2829.     for tone dialling or 'DP' for pulse dialling. Between these characters
  2830.     you can place any further modem commands, such as those which activate
  2831.     or deactivate error correction, handshaking options, duplexing or
  2832.     whatever else you wish. There are five prefixes defined in order to
  2833.     allow maximum flexibility.
  2834.  
  2835.  
  2836.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 43
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.     Terminal
  2846.  
  2847.     Select the method of terminal emulation you require from either
  2848.     TELETYPE, AVATAR, VT52 or ANSI.
  2849.  
  2850.     Teletype is just a case of sending everything that comes in through
  2851.     your serial port onto the screen. It's pretty basic. ANSI, on the
  2852.     other hand, gives full emulation of ANSI commands EXCEPT the ESC[=Psh
  2853.     command which sets the graphic mode, since this could play merry hell
  2854.     with PANTHER's output! Avatar is much like ANSI except that it uses
  2855.     shorter control strings to dictate output, therefore being slightly
  2856.     faster than ANSI, although there are few systems that actually support
  2857.     it as a standard. VT52 is a terminal emulation you may want to use if
  2858.     connecting to some forms of UNIX systems.
  2859.  
  2860.     Select whichever terminal emulation you have configured the remote
  2861.     system for. Also note that you can temporarily change the setting when
  2862.     on line as well, but more about that in a minute as well...!
  2863.  
  2864.     Protocol
  2865.  
  2866.     This defines the default file transfer protocol which will be used on
  2867.     this system. This is the protocol which will be first highlighted in
  2868.     the protocol menu (yes, that in a minute too!) when you start to
  2869.     download or upload a file. It will also be the protocol used when the
  2870.     script file encounters a DOWNLOAD or UPLOAD command whilst connected
  2871.     to this remote system. Choose YES if you wish to alter the default
  2872.     protocol. You will be presented with a menu listing all your installed
  2873.     protocols. Choose the new one using the scroll bar and the return key.
  2874.  
  2875.     Local Echo
  2876.  
  2877.     If you choose YES to this option then every character you type will be
  2878.     written to the screen and sent to the modem. This is only normally
  2879.     selected for terminal to terminal connections, since most bulletin
  2880.     boards will echo your characters back at you.
  2881.  
  2882.     Add Line Feed
  2883.  
  2884.     If you choose YES to this option then every return character you
  2885.     receive will cause a line feed to be added. Again, this is only
  2886.     normally selected for terminal to terminal connections, since most
  2887.     bulletin boards will automatically add line feeds for you.
  2888.  
  2889.     Dest. Backspace
  2890.  
  2891.     If you choose YES to this option then typing a backspace whilst on
  2892.     line will be 'destructive' in that it will delete the immediately
  2893.     preceding character and move the cursor back to that point, exactly
  2894.     like the DOS command line. If you select NO then a non-destructive
  2895.     backspace will be enabled which will only move the cursor back without
  2896.     overwriting the preceding characters.
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 44
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.     IEMSI
  2912.  
  2913.     If you select YES to the prompt to change the IEMSI packet then you
  2914.     will be presented with a menu of the ten possible IEMSI session
  2915.     packets. Those that have not yet been entered by you will be shown as
  2916.     UNDEFINED. Select the IEMSI packet by highlighting the name and
  2917.     pressing return. If you already have an existing IEMSI session defined
  2918.     for this entry and no longer wish to use it, select NONE. If you
  2919.     select an UNDEFINED packet then no changes will be made.
  2920.  
  2921.     Once you are satisfied that you have made all the changes you wish,
  2922.     pressing escape will cause the prompt
  2923.  
  2924.                        Save this directory entry? (Y/N)
  2925.  
  2926.     to appear at the foot of the screen. If you press 'Y' then the
  2927.     dialling directory will be updated with your changes. If you press 'N'
  2928.     then the editing session will abort and no changes will be made.
  2929.  
  2930.  
  2931.     DIALLING AND CONNECTING
  2932.     -----------------------
  2933.  
  2934.     If you press 'D' for dial or return when in the dialling directory,
  2935.     you will start to dial the highlighted system. Here's what happens;
  2936.  
  2937.     First of all, you can hit either escape or the space bar during the
  2938.     dialling procedure. Hitting escape will abort the dialling process
  2939.     altogether and will return you to the dialling directory. Hitting the
  2940.     space bar will have one of two effects; if you have several numbers
  2941.     'queued' by tagging them in the dialling directory then the current
  2942.     entry being dialled is aborted and goes to the back of the queue. The
  2943.     next number in the queue will then be dialled. On the other hand, if
  2944.     you are only dialling one number then the current attempt at
  2945.     connecting to it is aborted and the process will restart.
  2946.  
  2947.     PANTHER will first attempt to detect whether or not you have a live
  2948.     and working modem attached to your serial port. If you don't then an
  2949.     error (error #10, to be exact) will flash on the screen and you will
  2950.     be sent back to the dialling directory. If you DO have a working modem
  2951.     on the serial port in question (and you have specified the correct
  2952.     port, of course!) and this error occurs then try restarting PANTHER
  2953.     with the /NOCHECKING command line switch. Auto checking like this does
  2954.     not work with all modems. See the errors section of this manual for
  2955.     more advice on this situation.
  2956.  
  2957.     After this, PANTHER will attempt to detect and disable FIFO buffering
  2958.     found in 16550A UART chips, on the selected serial port. If the
  2959.     buffering is left active then PANTHER will not be able to initialise
  2960.     the port at all. After this, the port will be initialised using the
  2961.     required baud, parity, stop and data bits, following which FIFO
  2962.     buffering will be re-enabled.
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 45
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.     Next the string you have specified as 'RESET' in the modem strings
  2978.     configuration is sent to your modem and a response is awaited. If the
  2979.     response is your defined 'MODEM ERROR' string then an error message
  2980.     will be displayed, all queued dialling will be aborted (since your
  2981.     modem is not going to be initialised by any successive call) and the
  2982.     dialling process is terminated. However, if you receive the defined
  2983.     'MODEM OK' string then the 'INITIALISATION' string you have specified
  2984.     is sent to initialise the modem to the settings you require, which
  2985.     will again await either the 'MODEM OK' or 'MODEM ERROR' strings as
  2986.     before. After a response to this has been received, the dialling
  2987.     prefix you have specified will be sent to your modem, followed by the
  2988.     Mercury code (if required) followed by the number you wish to dial.
  2989.     The right hand side of the status line at the foot of the screen will
  2990.     show a decreasing counter showing the number of seconds of dialling
  2991.     time you have remaining. If you wish to temporarily alter this,
  2992.     pressing the up arrow key will increment the dialling time by five
  2993.     seconds and pressing the down arrow will decrement this value by five
  2994.     seconds. You cannot increment this value beyond 255 nor decrement it
  2995.     below zero. (obviously!) You ought to be able to hear your modem
  2996.     dialling the number (if you have a loudspeaker fitted to it) and then
  2997.     hear the appropriate telephone line signals of either ringing, engaged
  2998.     or, if you're just plain unlucky, disconnected!
  2999.  
  3000.     At this stage one of several things may occur. If the line is ringing
  3001.     and continues to do so beyond the dialling time then the words
  3002.     'DIALLING TIMED OUT' will appear on your screen and the dialling
  3003.     process will recommence. If the line is busy then the appropriate
  3004.     string returned by your modem on receiving an engaged line will be
  3005.     returned ONLY IF IT IS DEFINED IN THE 'BUSY STRINGS' SECTION OF THE
  3006.     MODEM CONTROL STRINGS IN THE CONFIGURATION MENU! If you haven't
  3007.     defined it then PANTHER will not be able to recognise nor interpret
  3008.     the current situation. This string is usually 'BUSY'. Consult your
  3009.     modem documentation for this. (Note : if your modem supports higher
  3010.     'X' result code commands then it will probably be able to detect the
  3011.     fact that the line is engaged prior to the dialling period timing out.
  3012.     Use these higher codes whenever possible - they will save you time) If
  3013.     the line is ringing but no answer is made then the dialling period
  3014.     will simply time out and recommence.
  3015.  
  3016.     If, however, the line is answered by the remote modem (and hopefully
  3017.     not some sleepy human being) then you ought to hear your modem
  3018.     'talking' briefly to the other one. After this, you ought to receive
  3019.     what is known as the 'connect string'. For this to be received
  3020.     properly, PANTHER must know what the connect string looks like. If the
  3021.     connect strings are not set up properly in the modem control strings
  3022.     section of the configuration menu then PANTHER will assume that no
  3023.     connection was made and the dialling process will recommence after
  3024.     timing out.
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 46
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.     Assuming, though, that all is well and the connection is made, you
  3044.     will see the connect string displayed on the screen followed by a
  3045.     brief tune announcing the connection. (if you have the sounds enabled)
  3046.     If you are contacting a system that you have never connected to
  3047.     before, then PANTHER will automatically ask you if you want to open a
  3048.     capture file. This may be useful since some systems show special
  3049.     information to new users and you may want to refer to it at a later
  3050.     date.
  3051.  
  3052.     After that you are connected to the remote system and you are
  3053.     communicating with the software being run by that system. A sample
  3054.     connection screen might look like this;
  3055.  
  3056. -----------------------------------------------------------------------------
  3057. CONNECT 14400/ARQ/V32/MNP
  3058.  
  3059.      █▀▀▀▀▀▀▀█▀▀▀█████▀▀▀▀▀▀▀█▀▀▀▀▀▀▀█▀▀▀▀▀▀▀███▀▀▀▀▀▀██▀▀▀▀▀▀██▀▀▀▀▀▀▀█
  3060. ┌───╖█ █▀▀▀█ █ █ █████ █▀█▀█ █ █▀▀▀█ █ █▀▀▀▀ ███ █▀▀█ ▀█ █▀▀█ ▀█ █▀▀▀▀ █┌───╖
  3061. │ ╔═╝█ █▀▀▀█ █ █ ▀▀▀▀█ █ █ █ █ █▀▀▀█ █ █ ▀▀▀▀███ █▀▀▀█ █ █▀▀▀█ █ ▀▀▀▀█ █╘═╕ ║
  3062. │ ║  █ ▀ █ ▀ █ ▀▀▀▀▀ █ ▀ ▄ ▀ █ ▀ █ ▀ █ ▀▀▀▀▀ ███ ▀▀▀▀▀ █ ▀▀▀▀▀ █ ▀▀▀▀▀ █  │ ║
  3063. │ ║  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  │ ║
  3064. │ ║  Voice: 0324 666336  Fax: 0324 665155  BBS: 0324 665371 (15 lines)  │ ║
  3065. │ ║                                                         ███▄▄         │ ║
  3066. │ ║     ┌──────────────────────────┐                       █████          │ ║
  3067. │ ║     │ Access to: Ilink, Usenet │                      █████           │ ║
  3068. │ ║     │   Basnet, Srcnet, Fido   │        ████         ▄█████           │ ║
  3069. │ ║     │ More than 300,000 files  │      █████     █▄  ▄▄████            │ ║
  3070. │ ║     │  60Mbyte new files each  │     ██████   ▄ ▄▄▄ ████████          │ ║
  3071. │ ║     │   week direct from USA   │    █████       ▀█████████▌           │ ║
  3072. │ ║     │   Vendor Support Confs   │                 ▐████████            │ ║
  3073. │ ║     │        2:259/17          │             ▄▄█████████████          │ ║
  3074. │ ║     └──────────────────────────┘                  ▀▀▀▀▀▀▀▀▀▀          │ ║
  3075. │ ║  ┌─────────────────────────────────────────────────────────────────╖  │ ║
  3076. │ ║  │    Sysop: Alastair McIntyre       PC Board S/No: 0011123/250    ║  │ ║
  3077. │ ╙─╖│   ───────────────────────────────────────────────────────────   ║┌─┘ ║
  3078. ╘═══╝│ Almac BBS Ltd, Heathpark, 141 Bo'ness Road, Grangemouth FK3 9BS ║╘═══╝
  3079.      ╘═════════════════════════════════════════════════════════════════╝
  3080.  
  3081. What is your first name?
  3082.  
  3083.  ALMAC BBS                  │CONNECT 14400│L19200 8-N-1│00:00:09│18:55:32│CS
  3084. -----------------------------------------------------------------------------
  3085.  
  3086.     In this example, the connect string received is shown at the top of
  3087.     the screen as CONNECT 14400/ARQ/V32/MNP which indicates the speed of
  3088.     the connection and the error correction method being employed. Your
  3089.     modem may not support many of these features so don't get worried if
  3090.     they don't appear!
  3091.  
  3092.     Beneath that comes the body of the text being received from the remote
  3093.     system, as text is received down the line it is shown on the screen
  3094.     using whatever terminal emulation you specified. As more text comes
  3095.     in, the existing text scrolls off the top of the screen.
  3096.  
  3097.  
  3098.  
  3099.  
  3100.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 47
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.     The bottom line (line 25) of the screen does not come from the remote
  3110.     system. It is the status bar which tells you something about how
  3111.     PANTHER is operating and what the line connection rate is. The left
  3112.     hand portion of the status line shows the name of the system you are
  3113.     connected to. The next portion shows the connection speed as taken
  3114.     from the connect string. The next portion shows the port status - in
  3115.     the above case the user would have been operating with a serial port
  3116.     locked at 19200 baud, signified by the 'L' character preceding the
  3117.     baud rate. If the port was unlocked then the port baud rate setting
  3118.     ought to match that of the connection speed. The 8-N-1 portion
  3119.     summaries the bit settings of the incoming data,m in this case 8 bits,
  3120.     no parity and 1 stop bit. After this appear two clocks; the one on the
  3121.     left shows the length of time that you have been on line for and the
  3122.     one on the right shows the time of day. The last three character
  3123.     spaces (although only two characters are being shown in this example)
  3124.     tell you something about the way PANTHER is actually operating. The
  3125.     left character shows you the capture file status. This can be either
  3126.     'C' indicating a capture file is active and operating, 'U' indicating
  3127.     that the capture file is active but has been suspended or nothing at
  3128.     all indicating that (go on, have a guess...) no capture file is being
  3129.     used. The second character tells you something about the status of the
  3130.     script file in use. This could be either 'S' if a script file is being
  3131.     used, 'L' if a script file is being learned, 'A' if you are in auto
  3132.     dialler mode (since you can't connect using the auto dialler facility
  3133.     without a script file!) or blank if no script file is being used at
  3134.     that time. The last character is a 'P' if a printer capture is
  3135.     activated or blank otherwise.
  3136.  
  3137.     Once you are on line and connected you are not entirely at the mercy
  3138.     of the remote system! There are various keystrokes which you can use
  3139.     to alter the way PANTHER is operating or change the manner in which
  3140.     the incoming data is being displayed. The keystrokes are mostly two
  3141.     key combinations such as ALT-A which mean you have to hold down the
  3142.     'ALT' key and press the 'A' key whilst still holding the 'ALT' key
  3143.     down. We kind of hoped you would know that but God knows, you have to
  3144.     document everything these days.
  3145.  
  3146.     The keystrokes available to you are as follows;
  3147.  
  3148.     ALT-A   Abandon the current script file if you are currently running
  3149.             one. The 'S' will disappear from the right hand corner of the
  3150.             status line and every keystroke will be up to you from that
  3151.             point. This may be useful if you wish to do more whilst on line
  3152.             than your script file normally allows.
  3153.  
  3154.     ALT-B   Send a BREAK signal to the remote system. This is required by
  3155.             some host systems to do certain tasks like ending
  3156.             transmissions.
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 48
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.     ALT-C   Change the capture file status. If a capture file is not
  3176.             running then you will be asked if you want to start one. If you
  3177.             reply that you do then you will be prompted for the name of the
  3178.             capture file to create. If that file already exists then it
  3179.             will be appended to, if it doesn't exist then it will be
  3180.             created.This file name defaults to PANTHER.CAP. If a capture
  3181.             file is running then you will be asked whether you want to stop
  3182.             it or to suspend it temporarily. If a capture file has been
  3183.             suspended then you will be asked whether you want to reactivate
  3184.             it or not. In any event, the keys to press in response are
  3185.             shown in brackets in the information box that appears on
  3186.             pressing this keystroke.
  3187.  
  3188.     ALT-D   Shell to DOS temporarily. The screen will clear and you will
  3189.             find yourself in a DOS session. To remind you that you are on
  3190.             line, the DOS prompt will change from your normal prompt into
  3191.             the rather alarming '[PANTHER ON-LINE!] $p$g'. To re-enter
  3192.             PANTHER, type EXIT <return> at the DOS prompt and you will find
  3193.             yourself at exactly the same position you were in before you
  3194.             shelled out.
  3195.  
  3196.     ALT-E   Toggle local echo on or off. Local echo will cause every
  3197.             character you type to be sent to the modem and written to the
  3198.             screen.
  3199.  
  3200.     ALT-F   Terminate script file learning mode. If you are learning a
  3201.             script file then you need not continue to do so until you log
  3202.             off. The script file will be closed and saved off to disk.
  3203.  
  3204.     ALT-G   Grab a coloured screen 'snapshot'. The current screen will be
  3205.             saved to the PANTHER.BIN file for viewing later through the
  3206.             colour snapshot viewer on the main menu. If you are using 24
  3207.             line mode then a dummy 25th line will be added to pad out the
  3208.             screen shot, therefore always retaining a consistent file
  3209.             size. There is no limit to the number of coloured snapshots
  3210.             you can save other than that of disk space. The PANTHER.BIN
  3211.             file is a straight binary save file, meaning that individual
  3212.             snapshots within it can be saved out (via the viewer) and
  3213.             loaded into other editors like TheDraw to do whatever you want
  3214.             with them.
  3215.  
  3216.     ALT-H   Hang up. Pressing ALT-H will pop up a small box asking you to
  3217.             confirm that you wish to hang up. If you confirm that you wish
  3218.             to do so, the carrier will be dropped and the session
  3219.             terminated. NOTE: Do NOT do this whilst in the middle of a
  3220.             session with a bulletin board unless there is no other option.
  3221.             Most system operators (sysops) give more than a little irked at
  3222.             people 'hopping on' and 'hopping off' in this manner, since
  3223.             their software may not always stand up to this manner of
  3224.             dropping carrier. Unless the remote software has locked up or
  3225.             there is no other manner of logging off (which unlikely) always
  3226.             log off using the manner which the remote software gives you.
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 49
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.     ALT-K   Kill an auto dialler session. If you have connected
  3242.             using the Auto Dialler facility, then pressing ALT-K will cause
  3243.             the Auto Dialler session (for the current connection only) to
  3244.             be terminated. Note that the script file running will not be
  3245.             terminated and will continue until aborted with the ALT-A
  3246.             keystroke. The reason for the ALT-K keystroke is this; if it is
  3247.             obvious that a script file is going awry or if you simply want
  3248.             to interrupt the script then aborting it with ALT-A will,
  3249.             during an Auto Dialler session, cause PANTHER to think that
  3250.             the script terminated prematurely and will drop carrier, as
  3251.             part of the inbuilt protection against Auto Dialler sessions
  3252.             leaving you on line for lengthy periods. By pressing ALT-K,
  3253.             this problem can be circumvented by simply telling PANTHER
  3254.             that the current connection must not be considered as an Auto
  3255.             Dialler connection.
  3256.  
  3257.     ALT-L   Toggle additional line feeds on or off.
  3258.  
  3259.     ALT-M   Modify the display type. This will pop up a small box asking
  3260.             you which of Teletype, ANSI, Avatar or VT52 terminal emulations
  3261.             you require. Pressing the bracketed initial letter shown of the
  3262.             display type will invoke that particular terminal emulation
  3263.             type. Incidentally, if you mess about with this for no good
  3264.             reason then don't blame us if your system grinds to a halt.
  3265.             PANTHER has a number of safety checks built into it to
  3266.             safeguard again corrupted information but it can't protect
  3267.             itself against loonys.
  3268.  
  3269.     ALT-N   Insert a note in the log file, if one is enabled. A small box
  3270.             will pop up inviting you to enter a line of text to be inserted
  3271.             in the log file. Once you have edited the line to your
  3272.             satisfaction, pressing enter will place that line into your log
  3273.             file. See the section on PANTHER's ancillary files for more
  3274.             details on the log file.
  3275.  
  3276.     ALT-P   Toggles printer capture on or off.
  3277.  
  3278.     ALT-R   Toggles the presence or absence of the status line. If a
  3279.             status line is enabled then pressing ALT-R will cause the whole
  3280.             screen to be used by the incoming data. Pressing ALT-R again
  3281.             will cause the status line to reappear.
  3282.  
  3283.     ALT-S   Take a snapshot of the current screen. The entire contents of
  3284.             the screen (but not the status line) will be captured and
  3285.             stored in the PANTHER.SNP snapshot file. This differs from
  3286.             the coloured (ALT-G) snapshot in that it is saved as text
  3287.             only.
  3288.  
  3289.     ALT-T   Toggles destructive backspace on and off.
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 50
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.     ALT-U   Upload a prepared text file. If you have to send messages over
  3308.             a bulletin board then preparing the text offline (ie, whilst
  3309.             not actually connected) can go some way to reducing your
  3310.             telephone costs. Instead of typing your messages into a text
  3311.             editor found on a bulletin board, enter the menu as per normal
  3312.             and press ALT-U. A small box will appear asking you for the
  3313.             name of the file containing your prepared text. Either type the
  3314.             name in and press enter, or press enter on the blank line and a
  3315.             scrolling directory listing will appear, allowing you to select
  3316.             the file you wish to upload. Once you have selected or entered
  3317.             the name of the file, PANTHER will read the contents of the
  3318.             file in a line at a time and send it to the remote system. This
  3319.             will continue until either then end of the file has been
  3320.             reached or you have aborted the process by pressing the escape
  3321.             key.
  3322.  
  3323.     ALT-V   View the scrollback buffer. Press escape to get back to
  3324.             PANTHER again.
  3325.  
  3326.     ALT-X   Send an XOFF character to the remote system. It is possible
  3327.             that spurious characters generated by line noise may send an
  3328.             XON character which may give you the impression that the
  3329.             connection has 'hung'. If you experience this, you may be able
  3330.             to resume the connection by sending an XOFF character.
  3331.  
  3332.     ALT-Y   Summon the internal file list editor.
  3333.  
  3334.     PageUp  Commence the file uploading process. This will invoke an
  3335.             protocol and will allow you to transfer files to the remote
  3336.             system. Initially, a scrolling menu will appear asking you to
  3337.             select the required transfer protocol. The highlighted entry in
  3338.             the menu will initially be the default protocol as entered in
  3339.             the dialling directory entry for the remote system, although
  3340.             any other protocol can be used, as long as the remote system
  3341.             knows which protocol you are using and is using it too. After
  3342.             you have selected the protocol, the next part is dependent on
  3343.             the upload command line you have defined for the protocol. If
  3344.             you have specified the PANTHER system variable '*FNAME' in the
  3345.             command line then a box will appear asking you for the name of
  3346.             the file to be uploaded. The box will be pre-filled with the
  3347.             last file name that appeared on the screen. (since the remote
  3348.             software has probably either asked you to type in the actual
  3349.             file name or knows it in advance, prompting you with something
  3350.             like 'ABOUT TO RECEIVE YOURFILE.ZIP') Either press return on
  3351.             the input line on the screen or retype the name of the file if
  3352.             it is wrong. You can also delete the name of the file in the
  3353.             box and press enter on the blank line to bring up a scrolling
  3354.             directory box which will show you the current contents of your
  3355.             upload directory, as defined in the paths section of the
  3356.             configuration menu. You can then select the file that you wish
  3357.             to upload - the menu will also allow you to move across
  3358.             directories, thereby allowing you to upload any file you have
  3359.             on your disk. Once you have selected or entered the name of the
  3360.             file, the protocol will execute. If a non-zero errorlevel is
  3361.             returned by the protocol then an error message will be
  3362.  
  3363.  
  3364.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 51
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.             generated advising you of a possible problem with the transfer.
  3374.             After the transfer has completed AND ONLY IF YOU HAVE RECEIVED
  3375.             A ZERO ERRORLEVEL FROM THE PROTOCOL PROGRAM (usually meaning
  3376.             that all went well with the protocol transfer) then PANTHER
  3377.             will inspect the file masks you have specified in the Mail
  3378.             Files section of the configuration menu. If the file you have
  3379.             just uploaded matches any of these file masks then - if a
  3380.             script file is not running - a box will pop up asking you if
  3381.             you wish to delete the file just uploaded. If you press 'Y'
  3382.             then the file will be deleted, pressing 'N' will leave it
  3383.             alone. After this, the transfer section is over and you will be
  3384.             returned to the session where you left off.
  3385.  
  3386.     PageDN  Commence the file downloading process. This will invoke an
  3387.             protocol and will allow you to transfer files from the remote
  3388.             system. Initially, a scrolling menu will appear asking you to
  3389.             select the required transfer protocol. The highlighted entry in
  3390.             the menu will initially be the default protocol as entered in
  3391.             the dialling directory entry for the remote system, although
  3392.             any other protocol can be used, as long as the remote system
  3393.             knows which protocol you are using and is using it too. After
  3394.             you have selected the protocol, the next part is dependent on
  3395.             the upload command line you have defined for the protocol. If
  3396.             you have specified the PANTHER system variable '*FNAME' in the
  3397.             command line then a box will appear asking you for the name of
  3398.             the file to be downloaded. The box will be pre-filled with the
  3399.             last file name that appeared on the screen. (since the remote
  3400.             software has probably either asked you to type in the actual
  3401.             file name or knows it in advance, prompting you with something
  3402.             like 'ABOUT TO SEND YOURFILE.ZIP') You must then enter the name
  3403.             of the file being downloaded and press return. Once you have
  3404.             entered the name of the file, the protocol will execute. If a
  3405.             non-zero errorlevel is returned by the protocol then an error
  3406.             message will be generated advising you of a possible problem
  3407.             with the transfer. After this, the transfer section is over and
  3408.             you will be returned to the session where you left off.
  3409.  
  3410.     F1      Shows a help screen summarising all the available keystrokes.
  3411.             It will also show you the password you have allocated for that
  3412.             connection - useful for those with short memories!
  3413.  
  3414.     F2      Shows a summary of all the keystroke macros you have defined.
  3415.             The macros are shown in their unexpanded format.
  3416.  
  3417.     F3      Show a scrolling list of files in the upload directory.
  3418.  
  3419.     F4      Show a scrolling list of files in the download directory.
  3420.  
  3421.     F5      Send the internal file list contents to the remote system. See
  3422.             the section on the internal file list for further details
  3423.             about this feature.
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 52
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.     In addition to the above keystrokes, there is one other very important
  3440.     keystroke which may be useful under certain circumstances.
  3441.  
  3442.     ALT-=   This keystroke disables ALL the above keystrokes. Why use
  3443.             this? Simply because it may occur that you will require one of
  3444.             these keystrokes for another purpose. it may also be that you
  3445.             have certain privileges on the system you are calling and have
  3446.             the ability to shell to DOS or run external programs such as
  3447.             text editors.This may require you to have keys such as F1 or
  3448.             any of the ALT key combinations available. By pressing ALT-=
  3449.             all the above PANTHER keys will be temporarily disabled
  3450.             allowing you to use them for other purposes. The only PANTHER
  3451.             keystroke which remains in force is ALT-= itself which will
  3452.             allow you to reset all the above keystrokes to their uses
  3453.             within PANTHER.
  3454.  
  3455.     Once you have completed your session, the carrier will be dropped and
  3456.     you will either be returned to the dialling directory if you were only
  3457.     dialling one number, or else the next number will be dialled if you
  3458.     have a series of connections queued for dialling.
  3459.  
  3460.     On exiting back to the dialling directory the figures for the number
  3461.     of calls and total time spent on line for each system you have been
  3462.     contacted will be incremented by the appropriate amount and the date
  3463.     and time of the last connection will be updated.
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 53
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.     FILE TRANSFER PROTOCOLS
  3506.     -----------------------
  3507.  
  3508.     A file transfer protocol (or protocol, for short) is best thought of
  3509.     as an agreed set of rules through which files can be transferred from
  3510.     one location to another over a communications link. In order to
  3511.     communicate and hence transfer information effectively, both the
  3512.     receiver (the 'downloader') and the sender (the 'uploader') must be
  3513.     using the same protocol, otherwise neither will understand what the
  3514.     other is doing.
  3515.  
  3516.     Numerous protocols exist, and the differences between them vary; some
  3517.     offer increased speed, some offer advanced error correction should
  3518.     transfers go wrong, some allow you to recommence transfers even if the
  3519.     link between the machines is severed and then reconnected. Others
  3520.     offer two-way transfers (allowing you to upload and download at the
  3521.     same time) and some even offer games to play whilst the transfer is in
  3522.     progress!
  3523.  
  3524.     PANTHER offers six internal protocols. These protocols are built into
  3525.     PANTHER itself and can be used with most remote systems who will offer
  3526.     at least one of these transfer systems, if not them all.
  3527.  
  3528.     When you wish to download or upload a file (or files - some protocols
  3529.     offer the ability to transfer several files at once) then you hit
  3530.     either the Page Down or Page Up keys respectively, depending on what
  3531.     sort of transfer you wish to make. In either case, all six protocols
  3532.     will be made available to you, along with any further external
  3533.     protocols you interface into PANTHER. (See the chapter on PANTHER's
  3534.     configuration to learn more about this.)
  3535.  
  3536.     Here's a sample download protocol menu, obtained by hitting Page Down
  3537.     key whilst on line, showing only the internal protocols.
  3538.  
  3539.                          ╔═════════════════════════╗
  3540.                          ║ Protocol Download Menu  ║
  3541.                          ║                         ║
  3542.                          ║   X - (I) Xmodem/CRC    ║
  3543.                          ║   K - (I) Xmodem-1K     ║
  3544.                          ║   M - (I) Xmodem-1KG    ║
  3545.                          ║   Y - (I) Ymodem        ║
  3546.                          ║   G - (I) Ymodem-G      ║
  3547.                          ║   Z - (I) Zmodem        ║
  3548.                          ╚═════════════════════════╝
  3549.  
  3550.     You can tell the internal protocols immediately - they will always be
  3551.     the first six on the menu, and just in case you get them confused with
  3552.     any others they are also prefixed by '(I)' to indicate that they are
  3553.     the (I)nternal protocols.
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 54
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.     Remember, before running the protocol, you *must* ensure that both you
  3572.     and the remote system are using the same protocol. Failure to use
  3573.     identical protocols will almost certainly mean an aborted transfer. To
  3574.     implement the required protocol, more the highlit bar to the
  3575.     appropriate protocol entry and press return. The protocol will then
  3576.     start up.
  3577.  
  3578.     The choice of which protocol to use is, of course, limited by what the
  3579.     remote system has to offer. However, most services offer the above
  3580.     protocols as standard, so what follows is a summarised view of each of
  3581.     PANTHER's internal protocols and what they offer;
  3582.  
  3583.     XMODEM/CRC - At one time this was the most popular protocol around but
  3584.     it has since fallen into disuse due to other newer protocols being
  3585.     both faster and more reliable. Files are sent in 'blocks' of 128
  3586.     characters, waiting each time for the receiver to signal an
  3587.     acknowledgement that the block was received intact. Error checking is
  3588.     performed by a Cyclic Redundancy Check on the block to ensure what was
  3589.     received is exactly what was sent. Although Xmodem is regarded as
  3590.     being 'old hat' it's almost guaranteed to be available on any remote
  3591.     system you care to mention.
  3592.  
  3593.     XMODEM-1K - This is almost identical to the above Xmodem except for
  3594.                 the fact that blocks comprise of 1024 characters at a
  3595.                 time.
  3596.  
  3597.     XMODEM-1KG - This is a faster version of the Xmodem-1k protocol.
  3598.                  However, it achieves this speed by not waiting for the
  3599.                  receiver to signal that each block was received intact.
  3600.                  This is really only designed for use in error-free
  3601.                  conditions such as cabled links between two computers. If
  3602.                  the receiver detects any errors during the transfer then
  3603.                  the whole transfer is simply aborted.
  3604.  
  3605.     YMODEM - This is effectively Xmodem-1k with batch facilities added to
  3606.              it - the ability to send multiple files during a single
  3607.              transfer. It can use either 128 or 1024 character blocks and
  3608.              also transfers in advance the name, size and date of the
  3609.              file(s).
  3610.  
  3611.     YMODEM-G - This is a faster version of the Ymodem protocol, much like
  3612.                Xmodem-1kG. It achieves its increased speed by not waiting
  3613.                for the receiver to signal that each block was received
  3614.                intact. It too is really only designed for use in error-free
  3615.                conditions such as cabled links between two computers. If
  3616.                the receiver detects any errors during the transfer then the
  3617.                whole transfer is simply aborted.
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 55
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.     ZMODEM - Devised by Chuck Forsberg for Telenet, Zmodem is by far and
  3638.              away the most popular, reliable, fastest and powerful protocol
  3639.              there is, and the one we would definitely recommend you use if
  3640.              the remote system offers it. It can transfer multiple files in
  3641.              a single batch, retains the files sizes, dates and names,
  3642.              forwarding these to the receiver in advance of the file being
  3643.              transferred. Files are not sent in blocks in the same manner
  3644.              as the previous protocols, but are really sent in 'data
  3645.              subpackets' of 1024 bytes apiece, along with header
  3646.              information and block check bytes. Each data subpacket in turn
  3647.              is sent in a 'frame' which can contain any number of data
  3648.              subpackets at a time. The receiver will, in general, only stop
  3649.              the transfer if a bad data subpacket is received. It doesn't
  3650.              even require the receiver to acknowledge receipt of packets,
  3651.              meaning a faster throughput all round.
  3652.  
  3653.              More significantly, Zmodem also has an ability called 'crash
  3654.              recovery' which gives it the ability to start a failed
  3655.              transfer from the point at which it failed. If you have been
  3656.              downloading a 500K file and the transfer fails at the 490K
  3657.              mark, it would be frustrating (not to mention expensive!) to
  3658.              have to start again from scratch. Zmodem gets round this by
  3659.              picking up the transfer from where it left off before, leaving
  3660.              only a 10K transfer to finish the file off. PANTHER's
  3661.              implementation of Zmodem will *only* overwrite a file if the
  3662.              incoming file is newer than the existing file, otherwise it
  3663.              will crash recover the existing file. (Note that PANTHER's
  3664.              internal Zmodem does *not* support Forsberg's CRC check which
  3665.              will check the actual contents of the file in question. If
  3666.              this facility is important to you then we suggest you use an
  3667.              external Zmodem such as Forsberg's DSZ.)
  3668.  
  3669.              Since the sender sends the details of the files being
  3670.              transferred, it is not necessary for you to enter the names of
  3671.              the files before the transfer gets under way. Since this is
  3672.              the case, PANTHER offers an 'Auto Zmodem Download' facility
  3673.              (which you can set from the Configuration/Program Settings
  3674.              menu) which will automatically start up a Zmodem download as
  3675.              soon as the Zmodem download string is received by PANTHER.
  3676.  
  3677.     It's important to note that by definition, and with the exception of a
  3678.     crash-recovering Zmodem, all the internal protocols will overwrite any
  3679.     existing files in your download directory with the same name as the
  3680.     incoming file. Losing files in this manner might just get a little
  3681.     wearing, so PANTHER has added a small facility to all its internal
  3682.     programs whereby it will automatically rename the INCOMING file to
  3683.     avoid destroying the existing file.
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 56
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.     For example, if you are downloading a file called BLACKCAT.ZIP and
  3704.     such a file already exists in your download directory, then PANTHER
  3705.     will cause the downloaded file to be called BLACKCAT.ZI0. It actually
  3706.     goes further than this - if *that* file exists then it will call the
  3707.     incoming file BLACKCAT.ZI1 and so on, incrementing the name of the
  3708.     incoming file's extension up to 999. Of course, if you actually
  3709.     *reach* BLACKCAT.999 then you really ought to be having a serious
  3710.     think about cleaning out your hard drive...
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 57
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.     INTERNAL FILE LISTING
  3770.     ---------------------
  3771.  
  3772.     One of the novel features in PANTHER is that of an internal file
  3773.     listing that can hold the names of up to 20 files and send that list
  3774.     up to the remote system on it requesting a list of required files.
  3775.     This list can be edited when either offline or online and has a couple
  3776.     of associated script file commands to assist with its use.
  3777.  
  3778.     For example, if you are either in the dialling directory, terminal
  3779.     mode or if on line then pressing ALT-Y brings up the internal file
  3780.     list editor as follows;
  3781.  
  3782.  
  3783.                             ┌─┤ EDIT FILE LIST ├─┐
  3784.                             │                    │
  3785.                             │ 1 -  ............  │
  3786.                             │ 2 -  ............  │
  3787.                             │ 3 -  ............  │
  3788.                             │ 4 -  ............  │
  3789.                             │ 5 -  ............  │
  3790.                             │ 6 -  ............  │
  3791.                             │ 7 -  ............  │
  3792.                             │ 8 -  ............  │
  3793.                             │ 9 -  ............  │
  3794.                             │ 10 - ............  │
  3795.                             │ 11 - ............  │
  3796.                             │ 12 - ............  │
  3797.                             │ 13 - ............  │
  3798.                             │ 14 - ............  │
  3799.                             │ 15 - ............  │
  3800.                             │ 16 - ............  │
  3801.                             │ 17 - ............  │
  3802.                             │ 18 - ............  │
  3803.                             │ 19 - ............  │
  3804.                             │ 20 - ............  │
  3805.                             └───┤ F10 QUITS ├────┘
  3806.  
  3807.     The highlight bar will initially be on the next free entry - if you
  3808.     have already defined five files then the highlight will be over the
  3809.     sixth entry. Simply type in the name of the file that you wish to add
  3810.     to the list and press return. It's as simple as that. The editor will
  3811.     only accept valid DOS characters.
  3812.  
  3813.     If you want to delete a file from the list simply delete the name from
  3814.     the list with the DEL key. The file listing is intelligent enough to
  3815.     pack your file entries together without leaving blank spaces. For
  3816.     example, if you specified files in positions 1, 3, 5 and 8 then the
  3817.     editor would pack the names together into positions 1, 2, 3 and 4.
  3818.     That way you avoid sending any 'blank lines' to the remote system for
  3819.     reasons that ought to become clear shortly.
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 58
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.     Once you have added all the files you want then press F10 and you will
  3836.     save the file listing and continue with whatever it was that you were
  3837.     doing before. If you do not wish to save the listing then pressing
  3838.     escape will discard any changes you have made.
  3839.  
  3840.     You may wish to delete the entire list - this is possible if you have
  3841.     acted on one file list and want to create another. Manually deleting
  3842.     each file name would be a rather cumbersome task but there is a faster
  3843.     way. If you enter DEL as the first file entry then all the file
  3844.     entries will be deleted and the file list editor will be back in its
  3845.     'empty' state.
  3846.  
  3847.     There is also an alternative way to enter file names into the editor.
  3848.     If you invoke PANTHER with the command line
  3849.  
  3850.                            PANTHER FILE=<FileList>
  3851.  
  3852.     then the first twenty lines of the ASCII file specified by <filelist>
  3853.     are read (or the whole of the file if there are less than twenty
  3854.     lines) and the file listing is 'filled out' with these lines. For
  3855.     example, if you have a file called MYFILES.DAT which looks like this
  3856.  
  3857.                                   FILE1.ZIP
  3858.                                   FILE2.ZIP
  3859.                                   FILE3.ZIP
  3860.  
  3861.     and you read in the file by running 'PANTHER FILE=MYFILES.DAT' then
  3862.     the file list will contain three entries, being the three files above.
  3863.     (It also means that your Sysop has a particularly boring way of naming
  3864.     his files but that's another matter altogether)
  3865.  
  3866.     Now we come to actually sending the files to the remote system; how do
  3867.     we do this? There are two methods. First however, let's have a look at
  3868.     how most systems actually ask for files from you.
  3869.  
  3870.     In 99% of cases we have come across, host systems generally ask you to
  3871.     file in the names of files in a line editor and then ask you to send a
  3872.     blank line to finish the list, something like this;
  3873.  
  3874.         Type '/q' on a blank line to abort download. Type '/e' to edit
  3875.         the download list. Type '/g' to start the download and log off
  3876.         afterwards. For a normal download, simply press <enter>.
  3877.  
  3878.         File(s) to download (#1): PANTHER.ZIP
  3879.         (1) PANTHER.ZIP (03:22, 343433 bytes)
  3880.  
  3881.         File(s) to download (#2): AVATAR.DOC
  3882.         (2) AVATAR.DOC (00:12, 6831 bytes)
  3883.  
  3884.         File(s) to download (#3): VGABLAST.ZIP
  3885.         (3) VGABLAST.ZIP (01:22, 131841 bytes)
  3886.  
  3887.         File(s) to download (#4):
  3888.  
  3889.  
  3890.  
  3891.  
  3892.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 59
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.     Now imagine that you've entered the three file names you want and now
  3902.     want to terminate the list and start the download - what you do here
  3903.     is simply press enter on the blank prompt for file #4 and the download
  3904.     will commence. PANTHER's internal file system works like this. When
  3905.     sending the files it appends (that means 'sticks on the end' for all
  3906.     you Canadian people out there) each file name with a return character
  3907.     and then sends these sequentially up the line, (to mimic you typing
  3908.     each file name and then pressing return) after which it then sends a
  3909.     final return character (to mimic you pressing return on the blank
  3910.     line) to tell the host you've finished with the list.
  3911.  
  3912.     You can now probably see why PANTHER intelligently 'bunches' all your
  3913.     file names together as described before. If it didn't then you'd be
  3914.     sending a spurious blank line halfway through entering the file names
  3915.     and all kinds of things could go wrong. You see? We think of
  3916.     everything and yet it's still free! Amazing!
  3917.  
  3918.     Sending the list to the host is simplicity itself - simply press F5
  3919.     and the list will be sent off up the line. Alternatively, you can do
  3920.     this through the script command SEND FILES. The other script command
  3921.     CLEAR FILELIST will erase all the files in the list for you. There is
  3922.     even a script function - FILELISTING - which you can use to determine
  3923.     if you have a file list set up or not. See the section on script file
  3924.     for more details on this.
  3925.  
  3926.     The big advantage to using a script like this is that it doesn't need
  3927.     to be changed for every new connection. If you simply edit an ASCII
  3928.     file to contain all the file names you want to appear in the file list
  3929.     then prudent use of the FILE= parameter, <QUIT> macro feature and SEND
  3930.     FILES and FILELISTING script directives can completely automate your
  3931.     file downloads with the minimum of intervention from you.
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 60
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.     RAW LOGGING
  3968.     -----------
  3969.  
  3970.     Raw logging is perfectly straightforward - it is activated by toggling
  3971.     the setting in the Programs Settings submenu within the configuration
  3972.     menu. When raw logging is active, every shred of data coming in
  3973.     through your serial port is captured to a raw log file. There are four
  3974.     terminal emulations within PANTHER; Teletype, ANSI, Avatar and VT52
  3975.     and the raw log file names reflect the emulation used; RAWLOG.TXT for
  3976.     Teletype, RAWLOG.ANS for ANSI, RAWLOG.AVT for Avatar and RAWLOG.V52
  3977.     for VT52.
  3978.  
  3979.     If you are using raw logs with one emulation and switch to another
  3980.     whilst on line with ALT-M then the former raw log file is closed and
  3981.     the raw log appropriate to the new emulation is opened and used.
  3982.     That's about it really.
  3983.  
  3984.     Unless you have mistakenly been using the Teletype emulation when the
  3985.     remote system has been sending ANSI codes or something, you ought to
  3986.     find that the RAWLOG.TXT file is just what its name suggests - plain
  3987.     ASCII, viewable through any file viewer, even the DOS TYPE command.
  3988.  
  3989.     However, if you view the ANSI, Avatar or VT52 raw logs then you will
  3990.     find then are a mixture of control codes and text, so you'll need some
  3991.     method to view them other than just TYPEing them to the screen. If you
  3992.     have the DOS device driver ANSI.SYS loaded then you could just TYPE
  3993.     the RAWLOG.ANS file to the screen, but the output might be rather fast
  3994.     and anyway, what about Avatar and VT52. Device drivers for these are
  3995.     very rare indeed, if not nonexistent.
  3996.  
  3997.     Luckily, PANTHER provides a viewer for all your RAWLOG.* files,
  3998.     accessible from the main menu. Once you select it from the main menu
  3999.     you get the following submenu;
  4000.  
  4001.                  ┌──────────────────────────────────────────┐
  4002.                  │         RAW LOG FILE VIEWER MENU         │
  4003.                  │       Select Choice or ESC to Quit       │
  4004.                  │                                          │
  4005.                  │      F1  View ANSI Raw Log File          │
  4006.                  │      F2  View Avatar Raw Log File        │
  4007.                  │      F3  View Teletype Raw Log File      │
  4008.                  │      F4  View VT52 Raw Log File          │
  4009.                  │      F5  Return To Main Menu             │
  4010.                  │                                          │
  4011.                  └──────────────────────────────────────────┘
  4012.  
  4013.     Go on...have a mad, rash and wild guess at what you do next...
  4014.  
  4015.     Once you start up the raw log viewer the screen clears to reveal a
  4016.     status line at the bottom and the selected raw log file is displayed
  4017.     on the screen in a 'continuous' mode.
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 61
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.     Whilst viewing the file you can speed the display up by (repeatedly)
  4034.     pressing the plus (+) key or slow it down by (repeatedly) pressing the
  4035.     minus (-) key. The delay between characters being processed is shown
  4036.     at the right of the status bar in milliseconds.
  4037.  
  4038.     You can pause the display by pressing 'P' and unpause it by pressing
  4039.     either 'P' or the space bar.
  4040.  
  4041.     Pressing escape takes you back to the raw log viewer menu again.
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 62
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.     SCROLLBACK BUFFER
  4100.     -----------------
  4101.  
  4102.     PANTHER features an internal scrollback buffer that allows you to view
  4103.     past data received. It can be accessed by either selecting the
  4104.     scrollback viewer from the main menu or by pressing ALT-V when on
  4105.     line, in terminal mode or from the dialling directory.
  4106.  
  4107.     As data enters the port, PANTHER interprets it according to the
  4108.     terminal emulation in force and filters out the control codes the
  4109.     terminal emulation uses. The remaining text is sent into the
  4110.     scrollback buffer. If the buffer fills up then data at the top of the
  4111.     buffer gets 'knocked off' to make room for the incoming data.
  4112.  
  4113.     The size of the scrollback buffer cannot be controlled by the user;
  4114.     PANTHER dynamically allocates memory to the scrollback buffer
  4115.     according to how much memory remains after the main program has
  4116.     loaded.
  4117.  
  4118.     When viewing the scrollback buffer, the text is displayed in
  4119.     monochrome. (yellow on black) Navigate through the buffer with the up
  4120.     and down arrow, home and end keys.
  4121.  
  4122.     To search for text in the buffer press 'F' and small box will appear
  4123.     on the screen asking you to fill in the text to be searched for.
  4124.  
  4125.     Pressing 'S' will allow you to save the entire buffer out to disk. If
  4126.     you do so, enter the buffer file name (without any extension) and it
  4127.     shall be saved out as plain text to the file specified.
  4128.  
  4129.     Alternatively, toggling the Buffer Dumping setting in the Program
  4130.     Settings menu to on will automatically dump the entire buffer out to a
  4131.     file called AUTOBUF.BUF on quitting PANTHER.
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.  
  4156.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 63
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.     SCRIPT FILES
  4166.     ------------
  4167.  
  4168.     PANTHER has a script language built into it which may take much of the
  4169.     effort out of repetitive tasks when on line, such as entering your
  4170.     name, password and so on.
  4171.  
  4172.     What is a script file? In its simplest format, it is somewhat similar
  4173.     to a DOS batch file, containing a list of prompts which your software
  4174.     will 'expect' to receive from the remote system, and a list of replies
  4175.     that it will send when it receives these prompts. Script files can
  4176.     automate the usage of PANTHER to the extent that little or no
  4177.     intervention may be needed from you when logging on.
  4178.  
  4179.     Obviously, this will require some knowledge of the system you are
  4180.     contacting and the prompts it uses. However, much of the work in
  4181.     creating script files can be avoided by using PANTHER's ability to
  4182.     learn and create script files as it goes along, without any
  4183.     intervention from you at all!
  4184.  
  4185.     Aside from 'learn' facility within PANTHER, script files can also be
  4186.     created by using any text editor or word processor capable of
  4187.     outputting plain ASCII text without any control characters or
  4188.     tabulations. If you haven't got a text editor then ensure your word
  4189.     processor is set to 'non-document' mode in order to save the script
  4190.     file out as ASCII. If you are unsure if your word processor can do
  4191.     this, edit a short (say, ten line) file in your word processor, save
  4192.     it out as TEST.DOC and exit to DOS. If, when you issue the DOS command
  4193.     'TYPE TEST.DOC', you see your file jumbled up with odd characters that
  4194.     you didn't type then you can be fairly sure that either your word
  4195.     processor isn't set up properly or else it is incapable of saving
  4196.     plain ASCII text. Almost any text editor will fit the bill -
  4197.     personally, we use the excellent QEDIT by SemWare - but just about any
  4198.     one will do.
  4199.  
  4200.     When running script files you might find that the script halts
  4201.     unexpectedly or that the remote system sends you a prompt that neither
  4202.     you nor the script file expected. To get round this problem, PANTHER
  4203.     also offers a script tracing facility through the TRACE command,
  4204.     allowing you to see exactly at which position the script file has
  4205.     reached and was instruction it is processing.
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 64
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231.     SCRIPT FILE COMMANDS
  4232.     --------------------
  4233.  
  4234.     Before explaining how script files actually work, let's list all the
  4235.     available PANTHER script file commands and their meanings;
  4236.  
  4237.     RECEIVE <string>   PANTHER will wait until string specified is
  4238.                        received. If the string is not received by PANTHER
  4239.                        within the length of time specified by you in the
  4240.                        'Default script time out' entry in the Program
  4241.                        Settings menu then the script will time out and
  4242.                        abort, although you will still remain on line. The
  4243.                        string you specify may be either in single quotes
  4244.                        (RECEIVE 'What is your name?'), double quotes
  4245.                        (RECEIVE "What is your name?") or in no quotation
  4246.                        marks at all. (RECEIVE What is your name?)
  4247.  
  4248.                        If you are unsure as to the exact case of the
  4249.                        prompt then you can use the /I switch on the
  4250.                        RECEIVE command to make the prompt case
  4251.                        insensitive. For instance, RECEIVE /I "This Prompt"
  4252.                        and RECEIVE /I "ThIs PrOmPt" are in effect
  4253.                        identical statements.
  4254.  
  4255.     MAYGET <string1> .SEND. <string2>
  4256.  
  4257.                        This is an extension of the above RECEIVE command.
  4258.                        It's really designed for use in situations where you
  4259.                        wish to get around prompts that only *might* appear,
  4260.                        for example new mail flags, bulletins or other
  4261.                        special messages. The command will *only* send
  4262.                        string2 back to the remote system *if* it finds
  4263.                        string1 in the script buffer of the last 255
  4264.                        characters received by you. If it cannot find
  4265.                        string1 in the buffer then nothing happens, but if
  4266.                        it does find the string in the buffer then it will
  4267.                        send string 2 back to the remote system and clear
  4268.                        out the script buffer at the same time so it won't
  4269.                        find the prompt again, much as RECEIVE does. One
  4270.                        other point to mention is that it is imperative the
  4271.                        '.SEND.' word in the command is flanked by two full
  4272.                        stops. This is because it is very possible that the
  4273.                        word 'send' could appear in one or other of the
  4274.                        strings and PANTHER would end up parsing the script
  4275.                        command inaccurately.
  4276.  
  4277.     SEND <string>      PANTHER will send the specified string to the
  4278.                        remote system. The string you specify may be either
  4279.                        in single quotes (SEND 'Joe Bloggs'), double quotes
  4280.                        (SEND "Joe Bloggs") or in no quotation marks at all.
  4281.                        (SEND Joe Bloggs) However, if you do not specify any
  4282.                        string in the script, and instead use the key word
  4283.                        INPUT (SEND INPUT) then a box will pop up on the
  4284.                        screen allowing you to type in whatever it is you
  4285.                        want sent to the remote system.
  4286.  
  4287.  
  4288.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 65
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.                        You can also issue the command SEND FILES at which
  4298.                        point PANTHER will send the contents of your
  4299.                        internal file list to the remote system.
  4300.                        Specifically, what it does is this; takes each file
  4301.                        name in the listing and appends a return (^M)
  4302.                        character to them then send them up the line one
  4303.                        after another, followed by a further return
  4304.                        character. You'd normally issue this command at the
  4305.                        point where the remote system is ready to accept a
  4306.                        list of files from you, so the return characters
  4307.                        are there to cause the remote system to accept each
  4308.                        name, and the final character is there to stop the
  4309.                        remote system from accepting any more as most
  4310.                        systems ask you to enter file names one after
  4311.                        another, plus a blank line (the final return) to
  4312.                        proceed.
  4313.  
  4314.     WAIT <seconds>     Your script file will wait for the number of seconds
  4315.                        specified before timing out. Effectively, this is a
  4316.                        way to increase the default script time out that you
  4317.                        have set up in the Program Settings menu,
  4318.                        on-the-fly. Of course, using this command within a
  4319.                        script file will not permanently affect your set up.
  4320.                        This command is generally used prior to a RECEIVE
  4321.                        command in circumstances where your normal script
  4322.                        time out would be too short. Once the script file
  4323.                        encounters a WAIT it alters the time out period to
  4324.                        the length of time you have passed it in the
  4325.                        command, then goes on immediately to the next line.
  4326.                        If PANTHER receives the RECEIVE string within the
  4327.                        period set up by the WAIT command then the script
  4328.                        time out period is reset back to the default,
  4329.                        otherwise the whole script file will time out as per
  4330.                        normal. If you pass NO parameters to the WAIT
  4331.                        command then it will WAIT indefinitely for the next
  4332.                        string to be received - handy if you are doing mail
  4333.                        (or other) downloads where you don't know quite how
  4334.                        long they will take.
  4335.  
  4336.     UPLOAD <filename>  Causes the file specified to be uploaded to the
  4337.                        remote system. The default protocol specified for
  4338.                        the remote system is used. By default, the file will
  4339.                        be taken from the directory you have specified as
  4340.                        the upload directory in the Paths menu. However, if
  4341.                        you specify a full qualified path name (for example,
  4342.                        C:\FILES\GAME.ZIP) then the file will be uploaded as
  4343.                        per the entire path name. If the file doesn't exist
  4344.                        then an error message will be generated.
  4345.  
  4346.     DOWNLOAD filename  Causes file specified to be downloaded from the
  4347.                        remote system. The default protocol specified for
  4348.                        the remote system is used. The file will be placed
  4349.                        into the directory you have set up as the download
  4350.                        directory in the Paths menu.
  4351.  
  4352.  
  4353.  
  4354.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 66
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.     DELETE filename    The file specified will be deleted, if it exists. If
  4364.     or                 the file doesn't exist then an error message will be
  4365.     ERASE filename     generated, although the script file will continue
  4366.                        to operate as normal.
  4367.  
  4368.     CAPTURE <on/off f> Turns a capture file on or off. An additional
  4369.                        second parameter (shown here as 'f') can be used to
  4370.                        specify the name of the capture file. If no name is
  4371.                        given for the capture file then the file will
  4372.                        default to the name PANTHER.CAP. If the capture
  4373.                        file exists when turned on the it will be appended
  4374.                        to, otherwise it will be created. It is probably
  4375.                        easiest to specify a capture file name as 'MYCAP'
  4376.                        since as part of its verification features, PANTHER
  4377.                        will not let you path a script file directed capture
  4378.                        file elsewhere and will not allow file extensions
  4379.                        other than '.CAP'. If you specify a file name such
  4380.                        as 'C:\CAPTURES\CAPFILE.1' then the script will
  4381.                        delete all extraneous information from the file name
  4382.                        and will create (or append to) a file called
  4383.                        CAPFILE.CAP within the program path as defined in
  4384.                        the configuration. A directive other than ON or OFF
  4385.                        will result in the CAPTURE instruction being
  4386.                        ignored.
  4387.  
  4388.     SOUND on/off       Turns sounds on or off. This might be useful for
  4389.                        late night work!
  4390.  
  4391.     TRACE on/off       Opens a script tracing window. When the TRACE ON
  4392.                        command is given then PANTHER will open a further
  4393.                        small window on the screen containing the current
  4394.                        script file command being processed. This way, you
  4395.                        can debug script files that appear to be going
  4396.                        astray by seeing at exactly which point the script
  4397.                        'breaks down' at. You will probably find that the
  4398.                        script window flickers rather a lot when data is
  4399.                        coming in through the serial port. This is
  4400.                        unavoidable since the trace window has to disappear
  4401.                        when data is coming in and reappear when data is
  4402.                        coming out in order to avoid corrupting the screen
  4403.                        display. The trace window is also intelligent
  4404.                        enough to know that it ought not to place itself
  4405.                        over the current cursor position, thereby obscuring
  4406.                        your view of the prompt.
  4407.  
  4408.                        There is one thing to watch out for, however - if
  4409.                        you use the OnScreen internal function and the
  4410.                        script trace window is placed over the expected
  4411.                        prompt then the script will *not* find the prompt.
  4412.                        Again, this is somewhat unavoidable as PANTHER
  4413.                        cannot tell in advance which prompts you will be
  4414.                        looking for and hence where to place the trace
  4415.                        window.
  4416.  
  4417.  
  4418.  
  4419.  
  4420.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 67
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.     HANGUP             Unconditionally drops the carrier and breaks the
  4430.                        connection. It's bad practice to do this if you are
  4431.                        in the middle of a session since it may hang the
  4432.                        remote system indefinitely. It's usually better to
  4433.                        break connection by logging off from the remote
  4434.                        system
  4435.  
  4436.     MINIMUM SPEED <n>  This is really only specified for the Auto Dialler,
  4437.                        although you might want to use it within your
  4438.                        'normal' script files as well. It demands that the
  4439.                        connection be made at _at_least_ the baud rate
  4440.                        defined as 'n'. If not, then the connection will be
  4441.                        broken. This is useful for systems that suffer
  4442.                        badly from 'line noise' that causes the negotiated
  4443.                        baud rate to drop, sometimes dramatically, causing
  4444.                        the whole operation to slow up. If you pass anything
  4445.                        other than a numeric argument 'n' to the command
  4446.                        then it will be ignored. Note that, although this
  4447.                        command (like any other) can be placed at any point
  4448.                        in the script file, it only really 'makes sense' to
  4449.                        have it as the first command in the script. Also,
  4450.                        watch out for silly entries like MINIMUM SPEED
  4451.                        1000000!
  4452.  
  4453.     PAUSE <seconds>    This will _unconditionally_ pause the processing of
  4454.                        the script file for the length of time specified.
  4455.                        This command is useful within script files for some
  4456.                        systems that utilise some text file displaying
  4457.                        utilities that pause themselves for a couple of
  4458.                        seconds before accepting keystrokes. Whereas WAIT is
  4459.                        used to delay the receipt of a string prompt, PAUSE
  4460.                        should be used to delay the sending of a string once
  4461.                        the prompt is received. If either a non-numeric
  4462.                        argument or no argument at all is passed to the
  4463.                        command then the command will be ignored.
  4464.  
  4465.     IF <condition>     Optionally executes a series of statements
  4466.     THEN               depending on the True/False value of the passed
  4467.       <statements>     condition. If the condition is true then the first
  4468.     ELSE               (THEN) set of statements are executed, otherwise
  4469.       <statements>     the second (ELSE) statements are executed. An ELSE
  4470.     ENDIFF             clause is optional, ie you can have
  4471.                        IF...THEN...ENDIFF but there must be a terminating
  4472.                        ENDIFF to indicate the end of the conditional
  4473.                        section. IF...ENDIFF constructions cannot be nested
  4474.                        at this stage, that is you cannot place another
  4475.                        IF...ENDIFF in the conditional statements of
  4476.                        another. More about conditions in a minute...
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 68
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.     WHILE <condition>  Optionally and continually executes a series of
  4496.       <statements>     statements depending on the True/False value of the
  4497.     WEND               passed condition. Literally, while the passed
  4498.                        condition is true then the <statements> will be
  4499.                        executed. If the condition is initially false then
  4500.                        the <statements> will never be executed and the
  4501.                        script process will jump straight over this
  4502.                        construction to the statement beyond the WEND. For
  4503.                        every WHILE statement there must be an associated
  4504.                        and unique WEND.
  4505.  
  4506.     REPEAT             Optionally and continually executes a series of
  4507.       <statements>     statements depending on the True/False value of the
  4508.     UNTIL <condition>  passed condition. Literally, the script will
  4509.                        repeatedly execute the <statements> until the
  4510.                        <condition> becomes true. If the condition is
  4511.                        initially true then the <statements> will only be
  4512.                        executed once and once only. For every REPEAT
  4513.                        statement there must be an associated and unique
  4514.                        UNTIL.
  4515.  
  4516.     CLRSCR             Clears the screen and resets screen text colour
  4517.                        to the default, ie light grey on black for all
  4518.                        terminal emulations except Avatar which uses cyan
  4519.                        on black.
  4520.  
  4521.     BEEP F D           Issues a beep from the speaker at frequency F for D
  4522.                        milliseconds. For example, BEEP 523 500 would give
  4523.                        you a middle C beep (523 MHz) for half a second.
  4524.                        (500 ms)
  4525.  
  4526.     DOS START          Execute a series of DOS commands. PANTHER actually
  4527.      <DOS statements>  takes the <DOS statements> and writes them out to a
  4528.     DOS STOP           DOS batch file called COS_SCR.BAT which it then
  4529.                        shells out to and executes, returning to PANTHER
  4530.                        when it quits. The <statements> can be absolutely
  4531.                        any DOS commands you like, either internal commands,
  4532.                        external utility programs or even whole applications
  4533.                        if you wish. When PANTHER shells to DOS it will
  4534.                        swap itself either to XMS, EMS or disk to allow as
  4535.                        much free memory for the child process as possible.
  4536.                        However, this will effectively render PANTHER's
  4537.                        interrupt driven system ineffective so ensure that
  4538.                        this command is only issued when neither you nor the
  4539.                        remote system are actually doing anything. That way
  4540.                        you won't lose any data. Notice also that it is
  4541.                        inadvisable to execute much in the way of complex
  4542.                        DOS commands in this manner when using the Auto
  4543.                        Dialler since a child program may hang (for whatever
  4544.                        reason) and you may be left on line for a long
  4545.                        period. If you must use the DOS START...DOS STOP
  4546.                        commands during an Auto Dialler session then make
  4547.                        sure the programs being called are reliable.
  4548.  
  4549.  
  4550.  
  4551.  
  4552.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 69
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.     LABEL LabelName    Marks a label point in the script to be used by
  4562.                        GOTO commands. The LabelName can be anything you
  4563.                        like, but make sure that labels in the same file
  4564.                        all have unique names, otherwise your GOTO commands
  4565.                        might just GOTO the wrong point!
  4566.  
  4567.     GOTO LabelName     Jumps the script to the specified LABEL point. If
  4568.                        the label doesn't exist then the script will
  4569.                        terminate.
  4570.  
  4571.     STOPSCRIPT         Simply stops the script file altogether and turns
  4572.                        all scripting off for that session.
  4573.  
  4574.     WARNING <string>   Displays the specified string in a neat little box
  4575.                        on the screen and issues a loud beep to draw your
  4576.                        attention.
  4577.  
  4578.     MESSAGE <string>   Displays the specified string in a neat little box
  4579.                        on the screen.
  4580.  
  4581.     LOGWRITE <string>  Write the string to the log file if its active.
  4582.  
  4583.     PRINTER on/off     Turn printer capture session on or off.
  4584.  
  4585.     MACRO <string>     The macro <string> passed is expanded and
  4586.                        activated. This is a simple and yet extremely
  4587.                        powerful command, since it directly gives script
  4588.                        files the ability to control any aspect of
  4589.                        PANTHER's operation. For instance, the script
  4590.                        command MACRO <ALT-C>YMYCAP.CAP^M would turn a
  4591.                        capture file session on by the <ALT-C> keystroke,
  4592.                        confirm the action with 'Y', enter the name
  4593.                        (MYCAP.CAP) and return that name (^M) for you.
  4594.                        Depending on circumstances, this may be a more
  4595.                        convenient way to activate some of PANTHER's
  4596.                        features through script files.
  4597.  
  4598.     IEMSI              Suspends script file operation whilst IEMSI
  4599.                        negotiations are under way.
  4600.  
  4601.     REN f1 f2          Renames a file from f1 to f2. Normal DOS rules
  4602.                        apply.
  4603.  
  4604.     COPY f1 f2         Copies a file f1 to f2. The target f2 can either be
  4605.                        a file name or a directory. Normal DOS rules
  4606.                        apply.
  4607.  
  4608.     MKDIR d1           Makes a directory called d1. This command can be
  4609.                        shortened to MD if preferred. Normal DOS rules
  4610.                        apply.
  4611.  
  4612.     RMDIR d1           Removes the directory d1, if possible. This command
  4613.                        can be shortened to RD if preferred. Normal DOS
  4614.                        rules apply.
  4615.  
  4616.  
  4617.  
  4618.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 70
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.     CHAIN Script       This causes PANTHER to close up the current
  4628.                        script file and 'chain' off to another one and
  4629.                        start running it from the beginning. Once the target
  4630.                        script file has been completed then script
  4631.                        activities cease, unless of course you chain off to
  4632.                        another script file.
  4633.  
  4634.  
  4635.     FUNCTIONS AND CONDITIONS
  4636.     ------------------------
  4637.  
  4638.     The conditional aspect of the IF...ENDIFF, RETURN...UNTIL and
  4639.     WHILE...WEND statements depends upon the truth of a condition attached
  4640.     to the query. Look upon it this way;
  4641.  
  4642.          IF Some event has happened
  4643.          THEN
  4644.             Do these statements
  4645.          ELSE
  4646.             The event hasn't happened so do these statements instead
  4647.          ENDIFF
  4648.  
  4649.          WHILE Some event hasn't happened
  4650.             Do these statements
  4651.          WEND
  4652.  
  4653.          REPEAT
  4654.            These statements
  4655.          UNTIL an event happens
  4656.  
  4657.     The whole concept is tied down to an event 'happening'. But how can
  4658.     you express what these events are and how can PANTHER determine
  4659.     whether or not they have happened or not?
  4660.  
  4661.     The latter question is easy - PANTHER just takes your instructions and
  4662.     determines their values internally through its script processor. The
  4663.     way that *you* tell PANTHER which conditions you want it to observe is
  4664.     through FUNCTIONS. Functions are generally called by passing
  4665.     parameters (or 'arguments') to the function in brackets. Functions
  4666.     only return two values; TRUE or FALSE.
  4667.  
  4668.     Here is a listing of PANTHER's internal functions;
  4669.  
  4670.        ONSCREEN (String)
  4671.          Returns TRUE if the specified string is anywhere on the screen,
  4672.          otherwise it returns FALSE.
  4673.          eg OnScreen (What is your name?)
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 71
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.        ONLINETIME (Seconds,Over/Under)
  4694.          Returns TRUE if the specified time (in seconds) is greater or
  4695.          less than the time you have been on line, depending on the second
  4696.          argument passed. For example, if you have been on line for three
  4697.          minutes the OnLineTime (100, Under) would be FALSE since you had
  4698.          been on line for over 100 seconds, whereas OnLineTime (120, Over)
  4699.          would be TRUE since you had been on line for more than 120
  4700.          seconds.
  4701.  
  4702.        DAYOFTHEWEEK (Day)
  4703.          Returns TRUE if the specified day matches the actual day of the
  4704.          week. The specified day can be any of Mon, Tue, Wed, Thu, Fri,
  4705.          Sat, Sun or Wkd, which means 'weekend'.
  4706.          eg DayOfTheWeek (Wed)
  4707.  
  4708.        TIMEOFDAY (Morning/Afternoon/Evening/Night)
  4709.          Returns TRUE if the current time of day falls within the given
  4710.          period. The periods are defined as follows; Morning = 0600 - 1200,
  4711.          Afternoon = 1200-1800, Evening = 1800-0000 and Night = 0000-0600.
  4712.          eg TimeOfDay (Night)
  4713.  
  4714.        QUESTIONBOX (String)
  4715.          Displays a box on the screen and prompts you to answer (Y/N) to
  4716.          it. Returns TRUE if you reply 'Y' and FALSE if you reply 'N'. One
  4717.          thing - if you are using Auto Dialler then you wouldn't want
  4718.          scripts sitting with a pretty little box expecting you to enter a
  4719.          prompt when you are elsewhere partying the night away, would you?
  4720.          As this is the case it is assumed that the answer to your query is
  4721.          'Y' if you are using Auto Dialler.
  4722.          eg QuestionBox (Are you sure you want to quit?)
  4723.  
  4724.        EXIST (Filename)
  4725.          Returns TRUE if the specified file exists, FALSE otherwise.
  4726.          eg EXIST (C:\CONFIG.SYS)
  4727.  
  4728.        FILELISTING
  4729.          Simply returns TRUE if you have an internal file listing
  4730.          specified, false otherwise.
  4731.  
  4732.        INBUFFER (String)
  4733.          Returns TRUE if the specified string can be found in the incoming
  4734.          script buffer. However, even if the function manages to find the
  4735.          string it will NOT reinitialise the buffer in the same manner that
  4736.          RECEIVE does, hence it will take a further RECEIVE command to
  4737.          clear the buffer out. One of the primary usages of the INBUFFER
  4738.          function would be as a loop control system such as
  4739.  
  4740.                  REPEAT
  4741.                     MAYGET "More (Y/N)" .SEND. "N^M"
  4742.                     MAYGET "Read Mail Now?" .SEND. "N^M"
  4743.                  UNTIL InBuffer ('Command?')
  4744.                  RECEIVE ('Command')
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 72
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.     Now how do you actually use these functions? It's really quite simple.
  4760.     Here are a few examples; (which is probably the best way to learn!)
  4761.  
  4762.       IF DayOfTheWeek(Tue)
  4763.       THEN
  4764.          <do some statements that apply to Tuesday only...>
  4765.       ELSE
  4766.          <do some statements that apply to any other day of the week...>
  4767.       ENDIFF
  4768.  
  4769.  
  4770.       REPEAT
  4771.          <do some things to download \DOWNLOAD\RECDFILE.ZIP>
  4772.       UNTIL Exist(\DOWNLOAD\RECDFILE.ZIP)
  4773.  
  4774.  
  4775.       WHILE OnScreen (Download file using Zmodem...)
  4776.          <while there are files to download...>
  4777.          DOWNLOAD
  4778.       WEND
  4779.  
  4780.     Functions can also be combined or even negated. For instance (I can't
  4781.     imagine why you would want to do this, but just suppose!) what if you
  4782.     only wanted to do something IF it's morning and IF you don't have a
  4783.     file called MORNING.LOG - how would you do this?
  4784.  
  4785.     The answer is to use PANTHER's functional operators .AND. .OR. and
  4786.     .NOT. which can combined the results of two (and only two) functions.
  4787.     For example, in the above instance you'd want to check the overall
  4788.     result of TWO functions, TIMEOFDAY (for the time of day being morning)
  4789.     and EXIST (for the presence of a file)
  4790.  
  4791.     How would you do this? Simple, negate the EXIST function with .NOT. to
  4792.     get its opposite result and then combine the results of the two
  4793.     functions with .AND. to get
  4794.  
  4795.              IF TimeOfDay(Morning) .AND. .NOT. Exist(MORNING.LOG)
  4796.  
  4797.     Note that the periods on either side of the .NOT., .AND. and .OR.
  4798.     operators are essential; PANTHER's internal script file parser
  4799.     requires them to be there for it to understand what you are talking
  4800.     about.
  4801.  
  4802.  
  4803.     INTERNAL VARIABLES
  4804.     ------------------
  4805.  
  4806.     In additional to all the above, the script file also understands four
  4807.     internal PANTHER variables. When placed in the script file, they will
  4808.     be read and expanded to their actual meaning. These variables are;
  4809.  
  4810.       *NAME          This is the full name as set up in the User's Name
  4811.                      entry in the Program Settings menu.
  4812.  
  4813.  
  4814.  
  4815.  
  4816.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 73
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.       *FIRST         This will return the Christian name extracted from the
  4826.                      User's Name entry in the Program Settings menu. Note
  4827.                      that if your name uses more than three 'words' (like
  4828.                      'Billie Jean King') then *FIRST will only return the
  4829.                      first word extracted from the name. This is only to
  4830.                      avoid an ambiguity.
  4831.  
  4832.       *LAST          This will return the surname extracted from the User's
  4833.                      Name entry in the Program Settings menu. Note that if
  4834.                      your name uses more than three 'words' (like 'Rip Van
  4835.                      Winkle') then *LAST will only return the last word
  4836.                      extracted from the name. This is only to avoid an
  4837.                      ambiguity.
  4838.  
  4839.       *PASSWORD      This will be expanded to give the password you have
  4840.                      allocated to the remote system in the dialling
  4841.                      directory.
  4842.  
  4843.       *UPLOADPATH    This will be expanded to the full upload path.
  4844.  
  4845.       *DOWNLOADPATH  Unless you're the victim of a cruel medical
  4846.                      experiment you can probably work this one out for
  4847.                      yourself.
  4848.  
  4849.       *PROGRAMPATH   This will be expanded to the main PANTHER directory.
  4850.                      However, unlike the 'Program Path' setting in your
  4851.                      configuration/paths set up., it will NOT be
  4852.                      terminated with a trailing '\' character.
  4853.  
  4854.     (It must be remembered here that the program path does *not* have a
  4855.     trailing backslash whereas the upload and download paths *do* have a
  4856.     training backslash. In short, they are expanded to exactly as they are
  4857.     shown in the paths settings in the configuration menu whereas the
  4858.     program path is *not*)
  4859.  
  4860.       *SCREENLINE[n] This one is slightly different; it will be expanded
  4861.                      to the 'nth' line on your screen, where the top line
  4862.                      is number one and so on down to twenty four or twenty
  4863.                      five, depending on whether or not you are using a
  4864.                      status line. This might be useful if you have to
  4865.                      capture node information about the remote system on
  4866.                      logging on, since you can divert the captured line to
  4867.                      the log file by using the LOGWRITE command, as in
  4868.                      LOGWRITE *ScreenLine[10] which will write out the
  4869.                      tenth line on the screen to the PANTHER.LOG file.
  4870.  
  4871.       # (hash)       This is interpreted as a 'return' character.
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 74
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.       ^ (caret)      To insert control characters into your script files,
  4892.                      use the caret notation. For example, ^M is interpreted
  4893.                      as CTRL-M, which would insert a return character into
  4894.                      your script prompts or strings. To insert a caret into
  4895.                      your prompts use two carets together, as in ^^. Some
  4896.                      of the more familiar control characters are
  4897.  
  4898.                              ^M        CR        Carriage Return
  4899.                              ^J        LF        Line Feed
  4900.                              ^L        FF        Form Feed
  4901.                              ^[        ESC       Escape
  4902.  
  4903.                      NOTE: If you are using XON/XOFF handshaking then take
  4904.                      care not to include either ^Q (XON) or ^S (XOFF)
  4905.                      characters in your SEND strings as they will probably
  4906.                      disturb transmission!
  4907.  
  4908.     Anything that PANTHER finds within a script file that it _doesn't_
  4909.     understand, it ignores. Also, you may freely add comments to the
  4910.     script file as long as occupy a line by themselves and are preceded by
  4911.     a semi colon character (;).
  4912.  
  4913.  
  4914.     HOW TO USE SCRIPT FILES
  4915.     -----------------------
  4916.  
  4917.     Script files MUST reside in the script directory as set up in the
  4918.     Paths menu. You cannot path a script file elsewhere.
  4919.  
  4920.     Using a script file you have created couldn't be easier. To cause a
  4921.     script file to be invoked merely enter the name of the script file
  4922.     into the SCRIPT entry in the dialling directory. NOTE THAT ALL SCRIPT
  4923.     FILES HAVE THE FILE EXTENSION '.SPT'. Don't enter this, just the
  4924.     file's name. So, for instance, if you have a script file by the name
  4925.     of ALMAC.SPT and you want to associate this with your entry for ALMAC
  4926.     BBS then edit the directory entry and include the name 'ALMAC'
  4927.     alongside the entry for 'Script File' and save it. Your dialling
  4928.     directory should then look something like this;
  4929.  
  4930.    ALMAC BBS                     │031 660 6680        │19200 │8-N-1│ALMAC
  4931.  
  4932.     Then just dial the number and the script file will start up. You can
  4933.     keep a check on the script file's 'status' by examining the bottom
  4934.     right corner of the status line. If a script file is currently in use
  4935.     then the centre character of the rightmost 'box' on the status line
  4936.     will be an 'S'. If the script is finished running or aborted (by
  4937.     pressing ALT-A when on line) then the character space will be blank.
  4938.     If, however, a script file is being learned by PANTHER then this
  4939.     character will appear on the status line as an 'L'.
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 75
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.     LEARNING SCRIPT FILES
  4958.     ---------------------
  4959.  
  4960.     To force PANTHER to learn a script file, just specify a NON-EXISTENT
  4961.     script file name in the dialling directory. PANTHER will detect the
  4962.     fact that a script is being requested and will start creating the
  4963.     script file for you. You can abort the learning process at any time
  4964.     whilst on line by pressing ALT-F. Note that terminating the learning
  4965.     process like this will save the script file off to disk.
  4966.  
  4967.     As an alternative to specifying a non-existent script file, hit ALT-0
  4968.     (alt-zero) on the dialling directory and you will toggle the script
  4969.     overwrite mode. Normally if PANTHER finds the script file specified in
  4970.     the dialling directory then it uses it, otherwise it learns it. The
  4971.     script overwrite method disables such intelligence and forces PANTHER
  4972.     to learn the script file whether it finds it or not. This will
  4973.     generally be more convenient than having to find unused script names,
  4974.     should you ever have to re-learn script files. However, be careful
  4975.     with this feature - if you have it set then it will overwrite any
  4976.     scripts you attempt to use. To this effect, a warning message flashes
  4977.     in the dialling directory alerting you to the fact that you have the
  4978.     script overwrite mode set. To unset it simply hit ALT-0 (alt-zero)
  4979.     again.
  4980.  
  4981.     There's one thing to remember when learning script file - don't learn
  4982.     scripts for systems you have never contacted before. You will
  4983.     generally find that most systems have a new set of procedures for new
  4984.     users and may take you through questionnaires and display 'first time'
  4985.     information to you. If you are learning a script file whilst doing
  4986.     this then you'll almost certainly find that it won't be right the
  4987.     second time! As a rule, don't specify scripts for new systems - leave
  4988.     them until the second time or after.
  4989.  
  4990.     Learned scripts will contain all the necessary commands required to
  4991.     emulate the 'learned' connection, with the notable exception of the
  4992.     PAUSE command, which cannot be learned. Since PANTHER would have
  4993.     difficulty in detecting whether a remote system is accepting
  4994.     keystrokes at that time, PAUSE commands will have to be manually
  4995.     entered into your script file (if necessary) using your text editor.
  4996.     Similarly, it would be presumptuous of PANTHER to add a MINIMUM SPEED
  4997.     directive to your scripts. If you require this command then it too
  4998.     will have to be manually edited into your script file.
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 76
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.     EXAMPLE SCRIPT FILE
  5024.     -------------------
  5025.  
  5026.     To demonstrate how to use PANTHER's script language, here's a example
  5027.     of what you might find in a script file. The following is a script
  5028.     file designed to log onto a PC-Board BBS system (I use ALMAC in this
  5029.     case but it could be any of them), download mail via the popular Qmail
  5030.     door, optionally download a filelisting every Thursday night and
  5031.     download any files mentioned in the internal file listing.
  5032.  
  5033.     ;====================================================================
  5034.     ;SCRIPT FILE STARTS HERE! Comments can be placed anywhere in a script
  5035.     ;file as long as they are preceded by a semi-colon.
  5036.     ;====================================================================
  5037.  
  5038.     MINIMUM SPEED 9600
  5039.     ;---------------------------------------------------------------------
  5040.     ;This command ensures that any connections made at speeds less than
  5041.     ;9600 are discontinued immediately.
  5042.     ;---------------------------------------------------------------------
  5043.  
  5044.     ;====================================================================
  5045.     ;      L O G     O N     S E C T I O N
  5046.     ;====================================================================
  5047.     ;The following commands simply get you logged on
  5048.     RECEIVE "Enter Language # to use (Enter)=no change?"
  5049.     LOGWRITE *SCREENLINE[7]
  5050.     ;---------------------------------------------------------------------
  5051.     ;The seventh line on the screen on PC-Board systems shows node
  5052.     ;information and may be useful to you if you get connection problems!
  5053.     ;---------------------------------------------------------------------
  5054.     SEND "2^M"
  5055.     RECEIVE "Do you want graphics"
  5056.     SEND "y^M"
  5057.     RECEIVE "What is your first name?"
  5058.     SEND "*NAME^M"
  5059.     RECEIVE "Is this correct?"
  5060.     SEND "^M"
  5061.     RECEIVE "Password (Dots will echo)? ("
  5062.     SEND "*PASSWORD^M"
  5063.  
  5064.     ;---------------------------------------------------------------------
  5065.     ;The next portion shows four prompts that *might* appear on your
  5066.     ;screen. If they do then the MAYGET command intercepts them and
  5067.     ;returns the appropriate response.
  5068.     ;---------------------------------------------------------------------
  5069.     REPEAT
  5070.        MAYGET 'More?' .SEND. 'N^M'
  5071.        MAYGET 'Read your personal mail now' .SEND. '^M'
  5072.        MAYGET 'Press (Enter) to continue?' .SEND. '^M'
  5073.        MAYGET 'Scan Message Base' .SEND. 'N^M'
  5074.     UNTIL InBuffer ('Main Board Command?')
  5075.  
  5076.  
  5077.  
  5078.  
  5079.  
  5080.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 77
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086.  
  5087.  
  5088.  
  5089.     RECEIVE "Main Board Command"
  5090.     SEND "open 7^M"
  5091.     WAIT
  5092.     ;---------------------------------------------------------------------
  5093.     ;The WAIT command merely delays the script file from timing out.
  5094.     ;---------------------------------------------------------------------
  5095.  
  5096.     ;====================================================================
  5097.     ;      Q M A I L     S E C T I O N   (DOWNLOADING)
  5098.     ;====================================================================
  5099.     RECEIVE "Qmail Command?"
  5100.     SEND "d^M"
  5101.     WAIT
  5102.     ;---------------------------------------------------------------------
  5103.     ;Again, another WAIT delay to allow the mail door to scan all the
  5104.     ;newsgroups and conferences...
  5105.     ;---------------------------------------------------------------------
  5106.     RECEIVE 'Do you wish to receive these messages (Y/N)?'
  5107.     SEND "Y^M"
  5108.     WAIT 200
  5109.     RECEIVE "Prepare to download ALMAC.QWK"
  5110.     DOWNLOAD
  5111.     ;---------------------------------------------------------------------
  5112.     ;Since I have the default protocol for ALMAC set to Zmodem then I
  5113.     ;don't have to specify the name of the file I am downloading!
  5114.     ;---------------------------------------------------------------------
  5115.     WAIT
  5116.  
  5117.     ;====================================================================
  5118.     ;      Q M A I L     S E C T I O N   (UPLOADING)
  5119.     ;====================================================================
  5120.     RECEIVE "Qmail Command?"
  5121.  
  5122.     ;---------------------------------------------------------------------
  5123.     ;The next bit will only upload messages *if* there are any in my
  5124.     ;upload directory, so the first thing to do is to check to see if
  5125.     ;there are any...
  5126.     ;---------------------------------------------------------------------
  5127.     IF Exist ('*UPLOADPATH\almac.rep')
  5128.     THEN
  5129.        ;do nothing - the script will just continue on from here.
  5130.     ELSE
  5131.     ;---------------------------------------------------------------------
  5132.     ;...and if there aren't, merely skip this section and go onto the
  5133.     ;next portion...
  5134.     ;---------------------------------------------------------------------
  5135.        GOTO ExecNet_Tape
  5136.     ENDIFF
  5137.     SEND "u^M"
  5138.     RECEIVE "Prepare to upload"
  5139.     UPLOAD ALMAC.REP
  5140.     ;---------------------------------------------------------------------
  5141.     ;Even with Zmodem you have to specify the name of the file to upload!
  5142.     ;---------------------------------------------------------------------
  5143.  
  5144.  
  5145.  
  5146.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 78
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.     ;---------------------------------------------------------------------
  5156.     ;The next portion awaits the result of the upload. If the word
  5157.     ;'unsuccessful' appears on the screen then retain the replies because
  5158.     ;you'll have to re-upload them. Otherwise it's safe to delete them. Of
  5159.     ;course, if you have *.REP defined as file mask in the 'mail files'
  5160.     ;section of the Configuration/Program Settings set up then it will
  5161.     ;delete the file without even asking you.
  5162.     ;---------------------------------------------------------------------
  5163.     IF OnScreen('unsuccessful')
  5164.     THEN
  5165.        ;do nothing
  5166.     ELSE
  5167.        DELETE "ALMAC.REP"
  5168.     WAIT
  5169.     RECEIVE "Qmail Command?"
  5170.  
  5171.     ;====================================================================
  5172.     ;      E X E C N E T     T A P E
  5173.     ;====================================================================
  5174.  
  5175.     LABEL ExecNet_Tape
  5176.  
  5177.     ;---------------------------------------------------------------------
  5178.     ;The following gives you gives you an example of combining two
  5179.     ;functions. It checks to see that *both* the day of the week is
  5180.     ;Thursday AND that it's evening.
  5181.     ;---------------------------------------------------------------------
  5182.     IF DayOfWeek(Thursday) .AND. TimeOfDay(Evening)
  5183.     THEN
  5184.        ;do nothing for the time being...question to follow
  5185.     ELSE
  5186.        GOTO DownloadFiles
  5187.     ENDIFF
  5188.     ;---------------------------------------------------------------------
  5189.     ;If the conditions are suitable then ask to see if you want the file
  5190.     ;lists or not.
  5191.     ;---------------------------------------------------------------------
  5192.     IF QuestionBox('Download the new file lists?')
  5193.     THEN
  5194.        SEND "q^M"
  5195.        RECEIVE "Main Board Command"
  5196.        SEND "j 5^M"
  5197.     ;---------------------------------------------------------------------
  5198.     ;Again, the following part will skip a couple of prompts that you only
  5199.     ;*might* get.
  5200.     ;---------------------------------------------------------------------
  5201.        REPEAT
  5202.           MAYGET "Scan Message' (Enter)=yes? " .SEND. "n^M"
  5203.           MAYGET "Press (Enter) to continue? " .SEND. "^M"
  5204.        UNTIL InBuffer ('Command')
  5205.     ;---------------------------------------------------------------------
  5206.     ;Remember, InBuffer() only checks to see if the specified prompt is
  5207.     ;actually in the incoming script buffer - it doesn't act on it. You
  5208.     ;need a RECEIVE for that.
  5209.     ;---------------------------------------------------------------------
  5210.  
  5211.  
  5212.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 79
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.        RECEIVE "Command"
  5222.        SEND "db^M"
  5223.        RECEIVE "(1)"
  5224.        SEND "WEEK1.ZIP^M"
  5225.        RECEIVE "(2)"
  5226.        SEND "^M"
  5227.        RECEIVE "(G)oodbye"
  5228.        SEND "g^M"
  5229.        DOWNLOAD
  5230.        WAIT
  5231.        RECEIVE "seconds. (H)angup now or (Ctrl-K) to cancel.."
  5232.        SEND "h"
  5233.        RECEIVE "Thanks for calling"
  5234.     ;---------------------------------------------------------------------
  5235.     ;The script has been designed to stop here and not go onto the file
  5236.     ;download sections - after all, a new file listing might change your
  5237.     ;file 'wants'!
  5238.     ;---------------------------------------------------------------------
  5239.        HANGUP
  5240.        STOPSCRIPT
  5241.     ENDIFF
  5242.  
  5243.     ;====================================================================
  5244.     ;     D O W N L O A D    F I L E S   I N   F I L E   L I S T I N G
  5245.     ;====================================================================
  5246.  
  5247.     LABEL DownloadFiles
  5248.     IF FileListing
  5249.     ;---------------------------------------------------------------------
  5250.     ;Remember the FileListing only returns TRUE if there are any files
  5251.     ;specified in PANTHER's internal file list.
  5252.     ;---------------------------------------------------------------------
  5253.     THEN
  5254.        SEND "q^M"
  5255.        RECEIVE "Main Board Command"
  5256.        SEND "j 5^M"
  5257.     ;---------------------------------------------------------------------
  5258.     ;Again, the following part will skip a couple of prompts that you only
  5259.     ;*might* get.
  5260.     ;---------------------------------------------------------------------
  5261.        REPEAT
  5262.           MAYGET "Scan Message' (Enter)=yes? " .SEND. "n^M"
  5263.           MAYGET "Press (Enter) to continue? " .SEND. "^M"
  5264.        UNTIL InBuffer ('Command')
  5265.        RECEIVE "Command"
  5266.        SEND "db^M"
  5267.        RECEIVE "(1)"
  5268.        SEND FILES
  5269.     ;---------------------------------------------------------------------
  5270.     ;The above command will send all of your files in the file listing,
  5271.     ;each followed by a return character, plus a further return character
  5272.     ;after they've all been sent to tell the remote system that you've
  5273.     ;finished sending your list.
  5274.     ;---------------------------------------------------------------------
  5275.  
  5276.  
  5277.  
  5278.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 80
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.        RECEIVE "(G)oodbye"
  5288.        SEND "g^M"
  5289.        DOWNLOAD
  5290.        WAIT
  5291.        RECEIVE "seconds. (H)angup now or (Ctrl-K) to cancel.."
  5292.        SEND "h"
  5293.        RECEIVE "Thanks for calling"
  5294.        HANGUP
  5295.     ENDIFF
  5296.  
  5297.     ;====================================================================
  5298.     ;     L O G G I N G     O F F
  5299.     ;====================================================================
  5300.  
  5301.     ;---------------------------------------------------------------------
  5302.     ;You'd only arrive at this point if all you had done was upload and
  5303.     ;download mail. You'd still be in the mail door itself so you now have
  5304.     ;to log off from it.
  5305.     ;---------------------------------------------------------------------
  5306.     LABEL LogOff
  5307.     SEND "g^M"
  5308.     RECEIVE "Thanks for calling"
  5309.     HANGUP
  5310.  
  5311.     ;====================================================================
  5312.     ;                 E N D   O F   S C R I P T   F I L E
  5313.     ;====================================================================
  5314.  
  5315.  
  5316.     HOW TO WRITE SCRIPT FILES
  5317.     -------------------------
  5318.  
  5319.     Assuming you don't want to use PANTHER's ability to learn script files
  5320.     for you, you can always write your own using a text editor, as
  5321.     mentioned previously.
  5322.  
  5323.     In order to be able to write your own script files, though, you must
  5324.     be at least partly aware of how it is that PANTHER deals with script
  5325.     files and acts on the prompts you include in them.
  5326.  
  5327.     The only command to note in this respect is the RECEIVE command. You
  5328.     will not be able (at least, not all the time) to use RECEIVE prompts
  5329.     if they are a considerable 'distance' up the screen from the cursor.
  5330.     PANTHER keeps a constant check on the characters you are receiving and
  5331.     maintains a list of the last 255 of them. If you ask PANTHER to
  5332.     RECEIVE a prompt (or part of a prompt) that is more than appeared on
  5333.     the screen more than 255 characters ago, then PANTHER will never find
  5334.     it and the chances are that your script file will fail.
  5335.  
  5336.     In general, the best prompts to choose for this purpose are found in
  5337.     the last few lines received. For example, if you wish a script file to
  5338.     automatically enter a menu choice for you from a menu that fills the
  5339.     screen and displays the prompt 'What is your choice? :', then this
  5340.     prompt - being the latest received by you - would be the most sensible
  5341.     to choose.
  5342.  
  5343.  
  5344.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 81
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.     Once PANTHER has recognised that it has indeed RECEIVEd the string you
  5355.     are asking for, then its blanks out the list of characters it is
  5356.     monitoring, in order that anything you receive after that will not be
  5357.     interfered with by past prompts.
  5358.  
  5359.  
  5360.     'SMART' SCRIPT FILES
  5361.     --------------------
  5362.  
  5363.     'What on Earth is a 'smart' script file?', I hear you ask. And well
  5364.     you may. This is a feature which is (we think!) unique to PANTHER and
  5365.     which might save a bit of time. Smart scripts are only used should a
  5366.     script file fail or start to fail. Huh? I'll try and explain...
  5367.  
  5368.     Picture the scene. You have set up a script file for your local BBS
  5369.     which will log you on, pick up your mail, upload your replies, grab
  5370.     the latest files listings and then log off. You've tested it and
  5371.     watched it doing its stuff and it works just fine. So you set up Auto
  5372.     Dialler to contact the BBS using your precious script file, whilst you
  5373.     are in your bed, dreaming of the day you'll own a better modem.
  5374.  
  5375.     Unknown to you, though, the BBS Sysop has stuck a temporary message on
  5376.     the board advising everyone of something - his holidays, Merry
  5377.     Christmas, the dog's not well or whatever. Say the message looks like
  5378.     this;
  5379.  
  5380.                   ╔═══════════════════════════════════════╗
  5381.                   ║      Would all users fill in the      ║
  5382.                   ║ questionnaire in mail area #2 please? ║
  5383.                   ║                Thanks.                ║
  5384.                   ║            Bob - BBS Sysop            ║
  5385.                   ╚═══════════════════════════════════════╝
  5386.                          Press [ENTER] to continue...
  5387.  
  5388.     What would happen? Well, your script file won't know about the 'Press
  5389.     [ENTER] to continue...' prompt sitting on your screen and will
  5390.     probably be sitting there, merrily waiting for a prompt which will
  5391.     never appear because it doesn't see what it is expecting.
  5392.  
  5393.     The final result will be that the script file will either time out
  5394.     (because it hasn't received the right prompt in time), if using the
  5395.     Auto Dialler then the maximum length of the Auto Dialler connection
  5396.     will be reached (eventually) or PANTHER will time out because it
  5397.     doesn't receive any data within the Auto Dialler Time Out period (as
  5398.     specified in the configuration menu) or else - if it's using smart
  5399.     enough software - the BBS itself will time you out.
  5400.  
  5401.     Either way, it means no carrier, no mail and no file listings. You get
  5402.     up the next morning to find that the connection has failed and mutter
  5403.     threats as you log on at a peak time to do the whole thing manually.
  5404.  
  5405.     Well, that WOULD be the case, except...it might not be. What happens
  5406.     is this;
  5407.  
  5408.  
  5409.  
  5410.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 82
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.     PANTHER knows that your script file is about to time out. What it
  5420.     does, just on the point where the script is about to time out, is lift
  5421.     the prompt from the screen and examine it, making a best guess as to
  5422.     what is required by the BBS, then sends that guess (with a return
  5423.     character) up the line in an attempt to get things moving again.
  5424.  
  5425.     If PANTHER cannot make head nor tail of the prompt then it tries a
  5426.     return character by default just to see what would happen. If that
  5427.     fails then the script will time out as normal and the connection will
  5428.     be broken.
  5429.  
  5430.     How does it do this? The answer is simple - it follows logical tests
  5431.     to try and work out what the BBS software wants. These tests check to
  5432.     see whether the prompt contains 'Y/N', 'Press RETURN', 'MORE?' or
  5433.     numerous combinations thereof and returns a 'best guess' character.
  5434.  
  5435.     Smart scripts will only be used ONCE. If the one attempt fails to do
  5436.     anything then the script is allowed to time out.
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472.  
  5473.  
  5474.  
  5475.  
  5476.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 83
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.     KEYSTROKE MACROS WITHIN PANTHER
  5486.     -------------------------------
  5487.  
  5488.     Macros are a handy way of saving you some time. With a macro, you can
  5489.     associate a line of text (or 'string' as it is more commonly known)
  5490.     with a particular keystroke. When that keystroke has been made, the
  5491.     line of text you have previously associated with that key will be sent
  5492.     to your modem. You can also run external programs from within macros.
  5493.  
  5494.     A macro is executed by pressing the associated keystroke. Macros can
  5495.     be executed from just about any part of PANTHER; menus, dialling
  5496.     directory, selection lists, terminal mode or on line. They also work
  5497.     from the command line, but more about that in a minute.
  5498.  
  5499.     EDITING MACROS
  5500.     --------------
  5501.  
  5502.     In order to set up your macros, press F5 from the main menu. The macro
  5503.     string editor will appear, which looks like this;
  5504.  
  5505. ┌─────────────────────────────┤ MACRO STRINGS ├──────────────────────────────┐
  5506. │ ALT-F1   JOE BLOGGS#...................................................... │
  5507. │ ALT-F2   *PASSWORD#....................................................... │
  5508. │ ALT-F3   ................................................................. │
  5509. │ ALT-F4   ................................................................. │
  5510. │ ALT-F5   ................................................................. │
  5511. │ ALT-F6   ................................................................. │
  5512. │ ALT-F7   ................................................................. │
  5513. │ ALT-F8   ................................................................. │
  5514. │ ALT-F9   ................................................................. │
  5515. │ ALT-F10  ................................................................. │
  5516. │ CTRL-F1  ................................................................. │
  5517. │ CTRL-F2  ................................................................. │
  5518. │ CTRL-F3  ................................................................. │
  5519. │ CTRL-F4  ................................................................. │
  5520. │ CTRL-F5  ................................................................. │
  5521. │ CTRL-F6  ................................................................. │
  5522. │ CTRL-F7  ................................................................. │
  5523. │ CTRL-F8  ................................................................. │
  5524. │ CTRL-F9  ................................................................. │
  5525. │ CTRL-F10 ................................................................. │
  5526. └─┤ # = RETURN CHAR, ~ = HALF SEC PAUSE, F1 HELP, F10 ACCEPTS, ESC ABORTS ├──┘
  5527.  
  5528.     All the possible 20 macro keystrokes are listed together with whatever
  5529.     text (if any) is associated with them. The above example shows what
  5530.     macros are created by the PANTHER installation program. (Although
  5531.     obviously your name will appear for ALT-F1 and not that of the
  5532.     ubiquitous Mr Bloggs.)
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.  
  5542.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 84
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.     On starting the macro editor the currently highlighted field will be
  5552.     that associated with ALT-F1. You can move to the field you wish by
  5553.     pressing the up and down arrow keys. When you reach the field you wish
  5554.     to edit, enter whatever text you wish, up to a limit of 200
  5555.     characters. Once you are happy with whatever text you have entered,
  5556.     press return to store that text in the field. Once you have edited all
  5557.     the macros you wish, press F10 to quit the macro editor and
  5558.     automatically save the macros to the disk file PANTHER.MAC. On the
  5559.     other hand, if you do not wish to keep the macros you have just
  5560.     edited, pressing escape will exit you from the editor with
  5561.     confirmation.
  5562.  
  5563.     When you are entering the text of your macros, you may use the
  5564.     following variables which will be expanded to their full meaning on
  5565.     being sent to your modem;
  5566.  
  5567.       *NAME      This is the full name as set up in the User's Name entry
  5568.                  in the Program Settings menu.
  5569.  
  5570.       *FIRST     This will return the Christian name extracted from the
  5571.                  User's Name entry in the Program Settings menu. Note that
  5572.                  if your name uses more than three 'words' (like 'Billie
  5573.                  Jean King') then *FIRST will only return the first word
  5574.                  extracted from the name. This is only to avoid an
  5575.                  ambiguity.
  5576.  
  5577.       *LAST      This will return the surname extracted from the User's
  5578.                  Name entry in the Program Settings menu. Note that if
  5579.                  your name uses more than three 'words' (like 'Rip Van
  5580.                  Winkle') then *LAST will only return the last word
  5581.                  extracted from the name. This is only to avoid any
  5582.                  ambiguity.
  5583.  
  5584.       *PASSWORD  This will be expanded to give the password you have
  5585.                  allocated to the remote system in the dialling directory.
  5586.  
  5587.       # (hash)   This is interpreted as a 'return' character.
  5588.  
  5589.       ~ (tilde)  This will cause the macro to pause for half a second at
  5590.                  that particular point.
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.  
  5608.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 85
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.  
  5616.  
  5617.       ^ (caret)  To insert control characters into your macro strings, use
  5618.                  the caret notation. For example, ^M is interpreted as
  5619.                  CTRL-M, which would insert a return character into your
  5620.                  macro. To insert a caret into your strings use two carets
  5621.                  together, as in ^^. Some of the more familiar control
  5622.                  characters are
  5623.  
  5624.                              ^M        CR        Carriage Return
  5625.                              ^J        LF        Line Feed
  5626.                              ^L        FF        Form Feed
  5627.                              ^[        ESC       Escape
  5628.  
  5629.                  NOTE: If you are using XON/XOFF handshaking then take
  5630.                  care not to include either ^Q (XON) or ^S (XOFF)
  5631.                  characters in your macro strings as they will probably
  5632.                  disturb transmission when connected to another system.
  5633.  
  5634.     The use of the tilde (~) character should be explained here. This can
  5635.     be useful for a number of things, mainly for sending often used
  5636.     strings to your modem from within terminal mode. For example, imagine
  5637.     you have the following macros set up for a keystroke;
  5638.  
  5639.                               'ATZ#~~~~ATS0=2#'
  5640.  
  5641.     What happens here is that when the keystroke is made, the macro is
  5642.     sent to the modem as usual. However, on reaching each tilde, the macro
  5643.     pauses for half a second. The reason this may be useful is to allow
  5644.     your modem two seconds (represented by the four tildes) to react to
  5645.     the initial 'ATZ' and then to send the following 'ATS0=2'. It may
  5646.     require a bit of experimenting to get the right delays between the
  5647.     commands and not have them 'overlap'.
  5648.  
  5649.     To allow PANTHER's macros to include the extended characters, it also
  5650.     understands the following symbols;
  5651.  
  5652.     [UP] [DOWN] [HOME] [END] [LEFT] [RIGHT] [PGUP] [PGDN] [TAB] [S-TAB]
  5653.     [DEL] [ESC] [F1] [F2] [F3] [F4] [F5] [F6] [F7] [F8] [F9] [F10] [ALT-A]
  5654.     [ALT-B] [ALT-C] [ALT-D] [ALT-E] [ALT-F] [ALT-G] [ALT-H] [ALT-I]
  5655.     [ALT-J] [ALT-K] [ALT-L] [ALT-M] [ALT-N] [ALT-O] [ALT-P] [ALT-Q]
  5656.     [ALT-R] [ALT-S] [ALT-T] [ALT-U] [ALT-V] [ALT-W] [ALT-X] [ALT-Y]
  5657.     [ALT-Z]
  5658.  
  5659.     It also understands the following internal strings from PANTHER's
  5660.     configuration;
  5661.  
  5662.     [RESET] [INIT] [MERCURY] [HANGUP] [PREFIX1] [PREFIX2] [PREFIX3]
  5663.     [PREFIX4] [PREFIX5]
  5664.  
  5665.     If you enter any of these exactly as above into a macro, then PANTHER
  5666.     will expand the symbol to the actual keystroke or string in question,
  5667.     which gives you a powerful means of controlling every aspect of
  5668.     PANTHER's operation.
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 86
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.     For example, imagine that you want to change all your configured
  5684.     protocols in the dialling directory to PANTHER's internal Zmodem. If
  5685.     you have a lot of entries in the directory then this would be
  5686.     extremely tedious - you'd have to edit every entry manually,
  5687.     navigating the menus and changing the protocols for each. Not so! If
  5688.     you set up a keystroke macro to do the donkey work then you could
  5689.     modify each entry in the dialling directory with only one keypress.
  5690.  
  5691.     The macro you'd enter would be something like this; (all in one line,
  5692.     of course)
  5693.  
  5694.     E[UP][UP][UP][UP][UP][RIGHT]^M[HOME][DOWN][DOWN][DOWN][DOWN][DOWN]^M
  5695.     [ESC]Y[DOWN]
  5696.  
  5697.     What does all this mean? Let's take each command in sequence so we can
  5698.     follow what's happening. Imagine that your in the dialling directory
  5699.     and activate this macro. Each tokenised macro keystroke (like [UP])
  5700.     gets expanded to its literal keystroke before being dealt with. So if
  5701.     you are sitting on an entry in your dialling directory, here's what
  5702.     happens when the macro starts;
  5703.  
  5704.     E                    - Calls the directory entry editor
  5705.     [UP][UP][UP][UP][UP] - Moves the highlit bar in the directory entry
  5706.                            editor up to the entries default protocol.
  5707.     [RIGHT]              - Moves the highlit YES/NO box at the foot of the
  5708.                            screen to YES
  5709.     ^M                   - Selects the YES box and brings up the protocol
  5710.                            menu.
  5711.     [HOME]               - Sends the protocol menu bar to the top of the
  5712.                            menu. This is worth emphasising; not all the
  5713.                            entries in your dialling directory may have the
  5714.                            same protocol set. If that's the case then if
  5715.                            you were merely to move the scroll bar to the
  5716.                            Zmodem entry then it wouldn't necessarily do the
  5717.                            same for any other entries who used a different
  5718.                            default protocol. By moving the highlit bar to
  5719.                            the uppermost position with [HOME] you are
  5720.                            making them all start from a common position.
  5721.     [DOWN][DOWN][DOWN]   - Moves the protocol menu bar down five lines to
  5722.     [DOWN][DOWN]           the Zmodem entry.
  5723.     ^M                   - Selects Zmodem and gets rid of the protocol
  5724.                            menu.
  5725.     [ESC]                - Quits from the dialling directory editor.
  5726.     Y                    - Confirms that you wish to save that entry and
  5727.                            then gets rid of the editor menu.
  5728.     [DOWN]               - Moves you onto the next entry in the dialling
  5729.                            directory, ready to start again.
  5730.  
  5731.     With a bit of imagination you can set up macros to perform all kinds
  5732.     of tasks - set your modem to auto answer in terminal mode, make global
  5733.     changes to your dialling directory as described, navigate all menus,
  5734.     screens and editors - whatever you like!
  5735.  
  5736.  
  5737.  
  5738.  
  5739.  
  5740.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 87
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.     Macros can also be used to run external programs! To do this, enter
  5750.     your program into a macro as [@C:\DIR\PROGNAME.EXE] If the program
  5751.     resides on your DOS PATH then there is no need to specify the
  5752.     directory; PANTHER will find it for you! When running the external
  5753.     program, PANTHER will swap out to XMS, EMS or disk, depending upon
  5754.     resources. As with shelling to DOS, this will disable all PANTHER's
  5755.     interrupts so if you are going to perform this kind of macro on line
  5756.     ensure you do so when there is no activity online.
  5757.  
  5758.     There is one further use for macros. They can also be invoked from the
  5759.     command line to allow you to set up entire tasks or operations without
  5760.     having to enter any keystrokes in PANTHER at all.
  5761.  
  5762.     To do this, have your macro emulate every keystroke you would normally
  5763.     press to get you to dial the desired entry. For example, the following
  5764.     macro would dial the first entry in the dialling directory
  5765.  
  5766.                                    ^M[F1]^M
  5767.  
  5768.     The initial ^M (return) character would get you past the initial
  5769.     PANTHER introductory screen, the F1 would take you into the dialling
  5770.     directory and the final return character would dial the highlit entry,
  5771.     which would be the first in the directory. If you were to save this
  5772.     macro to, say, ALT-F3 in the macro editor, then it would be the third
  5773.     macro specified. You can then auto start it by starting up PANTHER
  5774.     with
  5775.  
  5776.                                PANTHER MACRO=3
  5777.  
  5778.     and you would see your macro start up PANTHER, navigate its menus and
  5779.     start dialling for you! If you are running Windows, OS/2 or some other
  5780.     graphical environment then you could set up individual icons to
  5781.     perform individual connections. Alternatively, a DOS batch file could
  5782.     be written to start specific connections in this way.
  5783.  
  5784.     When using PANTHER macros in this way, you would find that the macro
  5785.     would be able to take you into the dialling process and get you on
  5786.     line - but what about when the connection is finished? Since the macro
  5787.     is only emulating keystrokes then you would find that PANTHER would
  5788.     still be running after the connection was made. This might be a real
  5789.     problem, particularly if you are running PANTHER under a multitasking
  5790.     system and find it continues to run in the back ground, stealing CPU
  5791.     time for no reason.
  5792.  
  5793.     But as usual we've come up with a solution. If you commence your
  5794.     command line invoked macro with the symbol [QUIT] then the macro will
  5795.     tell PANTHER to quit as soon as the connection is broken. To go back
  5796.     to our original example, if you started up PANTHER with the macro
  5797.  
  5798.                                 [QUIT]^M[F1]^M
  5799.  
  5800.     then PANTHER would start up, dial the first entry in the dialling
  5801.     directory and then shut down altogether as soon as you came off line.
  5802.  
  5803.  
  5804.  
  5805.  
  5806.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 88
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815.     If you have many dialling directory entries and wish to initiate them
  5816.     all from the command line like this, you'll soon find out you'll run
  5817.     out of macros - PANTHER only lets you define twenty, after all. Yet
  5818.     again, we have a solution. You can define a macro on the command line
  5819.     itself using the KEYS parameter. For example, rather than define the
  5820.     above macro in a macro 'slot', define it on the command line instead
  5821.     like this;
  5822.  
  5823.                          PANTHER KEYS=[QUIT]^M[F1]^M
  5824.  
  5825.     That way you can run your macro without any problem and keep the slot
  5826.     free for something more useful. The only drawback to command line
  5827.     defined macros like this is that they (obviously) cannot contain space
  5828.     characters, since DOS would split a command line parameter with a
  5829.     space in it into two parameters. However, this ought not to be a
  5830.     drawback since, raw text aside, there are always other ways of using
  5831.     PANTHER than by the space bar.
  5832.  
  5833.     IMPORTANT NOTE FOR USERS OF JP SOFTWARE'S 4DOS! You'll find that if
  5834.     you run the above command, 4DOS will split it into three commands due
  5835.     to its ability to run multiple commands on one command line, separated
  5836.     by the caret (^) character! To circumvent this problem, you can use an
  5837.     asterisk (*) character instead of the caret character to indicate
  5838.     'control' characters in this manner. However, not that this will ONLY
  5839.     happen if you are specifying a macro on the command line and ONLY if
  5840.     you are running 4DOS!
  5841.  
  5842.     So in summary, if you combine command line macros defined with either
  5843.     the KEYS or MACRO parameters, with PANTHER's powerful script language
  5844.     then you can set up individual jobs - be they batch files, Windows
  5845.     sessions or OS/2 objects - to start up PANTHER, dial a selected entry
  5846.     in your dialling directory, get on line, perform all the actions in
  5847.     the script file, log off and then quit PANTHER completely!
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.  
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.  
  5872.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 89
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.     AUTO DIALLER
  5882.     ------------
  5883.  
  5884.     PANTHER has the facility to allow you to specify up to five entries
  5885.     from any single dialling directory and connect to them on a timed
  5886.     basis. This facility is enabled through easy to use menus to create
  5887.     the Auto Dialler control files and is completely automated.
  5888.  
  5889.     Before you start getting nervous, PANTHER also has a number of built
  5890.     in safety checks to ensure that, should anything go wrong, your modem
  5891.     will not be left on line for any longer than you specify.
  5892.  
  5893.     Using the Auto Dialler command itself can either be made through
  5894.     PANTHER's own menu system, or through a command line switch. The
  5895.     former method allows you to set up an Auto Dialler session that can be
  5896.     set as far ahead as (almost) twenty four hours. The latter method may
  5897.     be used in conjunction with other mechanisms (such as a software timer
  5898.     or a timed power supply to your computer) to allow you to set up Auto
  5899.     Dialler sessions for whenever you wish.
  5900.  
  5901.     An Auto Dialler session can only be run on dialling directory entries
  5902.     that have an associated script file whose commands will take the
  5903.     session from the beginning right through to the end. If a script file
  5904.     terminates prematurely (for example, by forgetting to issue the
  5905.     command to log off) then the script file will close as normal but the
  5906.     Auto Dialler session will continue! It is most important to realise
  5907.     that it is the users sole responsibility to ensure that scripts are
  5908.     both complete and have been fully tested prior to their being used on
  5909.     an Auto Dialler session.
  5910.  
  5911.     In saying all the above, it must be borne in mind that PANTHER has
  5912.     been designed to cope with any unexpected problems whilst an
  5913.     unattended Auto Dialler session is in progress. These safeguards are
  5914.     as follows;
  5915.  
  5916.     - If a script file times out (ie, is waiting for a prompt that never
  5917.       arrives within the script file time out period) then the Auto
  5918.       Dialler session is aborted.
  5919.  
  5920.     - If you try to Auto Dial to a system which has no script file
  5921.       associated with it then Auto Dialler will refuse to allow you to
  5922.       include this entry in a control file during the set up process.
  5923.  
  5924.     - If your modem does not receive any incoming data within the Auto
  5925.       Dialler Time Out period specified in the configuration, then the
  5926.       connection will be aborted since it will be assumed the remote
  5927.       system has 'hung'.
  5928.  
  5929.     - The MINIMUM SPEED directive in the script language ensures that a
  5930.       minimum baud rate is required before the connection is made, thereby
  5931.       ensuring that you won't be on line any longer than you have to be
  5932.       because of a slow data transfer rate.
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 90
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.     - As part of the Auto Dialler control file set up, you specify the
  5948.       maximum length of time the modem will stay on line for each
  5949.       connection.
  5950.  
  5951.     As a final (possible) precaution, it must also be remembered that most
  5952.     modern host systems will time YOU out if you don't send any data back
  5953.     to it within a specified time period.
  5954.  
  5955.     When an Auto Dialler session is running, all PANTHER's actions are
  5956.     controlled via the commands in the script language. That way, no menus
  5957.     or selection boxes occur on the screen. All your capture files,
  5958.     uploading, downloading and deleting are controlled by your scripts.
  5959.  
  5960.     Auto Dialler sessions also implement the 'smart scripts' ability to
  5961.     (possibly) get out of situations where your script file has gone
  5962.     astray. In short, this is the completely automatic ability for PANTHER
  5963.     to tell where a script is going wrong and to correct it by sending the
  5964.     appropriate keystrokes automatically! See the section of this manual
  5965.     on script files for more details about 'smart scripts'.
  5966.  
  5967.     Auto Dialler has many uses - some we probably haven't yet envisaged
  5968.     ourselves - but the main advantage in it the ability to log onto busy
  5969.     systems during the middle of the night when traffic is light, without
  5970.     having to stay awake for it!
  5971.  
  5972.  
  5973.     SETTING UP AN AUTO DIALLER CONTROL FILE
  5974.     ---------------------------------------
  5975.  
  5976.     This couldn't be made much easier if we tried. From the main menu,
  5977.     press F4 or scroll the highlight bar down to the 'Auto Dialling
  5978.     Facility' title to enter the Auto Dialler function. Once you have done
  5979.     so, you will see a menu something like this;
  5980.  
  5981.             ┌───────────────────────────────────────────────────┐
  5982.             │                 AUTO DIALLER MENU                 │
  5983.             │           Select Choice or ESC to Quit            │
  5984.             │                                                   │
  5985.             │     >F1  Set Up Auto Dialler Control File         │
  5986.             │      F2  Auto Dial Using PANTHER Directory        │
  5987.             │      F3  Auto Dial Using STR_BEAN Directory       │
  5988.             │      F4  Auto Dial Using EUROPE Directory         │
  5989.             │      F5  Auto Dial Using FIDONET Directory        │
  5990.             │      F6  Auto Dial Using SUPPORT Directory        │
  5991.             │      F7  EXIT                                     │
  5992.             │                                                   │
  5993.             └───────────────────────────────────────────────────┘
  5994.  
  5995.     If you haven't already set up any Auto Dialler control files then you
  5996.     will only see the first and last lines. The others in the middle are
  5997.     for starting up an Auto Dialler session. For the time being, let's
  5998.     concentrate on getting the control file created.
  5999.  
  6000.  
  6001.  
  6002.  
  6003.  
  6004.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 91
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.     Pressing F1 for the Set Up routine brings up a further scrolling menu
  6014.     of all the dialling directories you have on your disk, thus;
  6015.  
  6016.    ┌─────────────────────────────────────────────────────────────────────┐
  6017.    │    In order to create an Auto Dialler control file, PANTHER must    │
  6018.    │    know from which dialling directory your entries are to be made.  │
  6019.    │    Please select the directory from which the control file is to be │
  6020.    │    constructed.                                                     │
  6021.    └─────────────────────────────────────────────────────────────────────┘
  6022.  
  6023.            ┌─C:\PANTHER\*.PHN────────────────────────────────────┐
  6024.            │>PANTHER.PHN     1692    Apr 19,1992     1:03a     A<│
  6025.            │ EUROPE.PHN        94    Apr 08,1992     5:57a     A │
  6026.            │ LONGDIST.PHN     658    Apr 16,1992     1:08a     A │
  6027.            │ FIDONET.PHN      188    Apr 08,1992     5:57a     A │
  6028.            │ SUPPORT.PHN       94    Apr 18,1992     7:48a     A │
  6029.            │ STR_BEAN.PHN     376    Apr 18,1992     6:47p     A │
  6030.            │                                                     │
  6031.            │                                                     │
  6032.            └─────────────────────────────────────────────────────┘
  6033.  
  6034.     Move the scrolling highlight bar in the directory list window and
  6035.     select the dialling directory from which you wish the Auto Dialler
  6036.     control file to be made. Now, one of two things will happen. If you
  6037.     already have a control file for the dialling directory you will be
  6038.     taken straight into editing it. However if you don't then you will be
  6039.     invited to select which systems you wish to contact. We will assume
  6040.     the latter situation by selecting LONGDIST.PHN from the directory. (If
  6041.     a control file for this directory had existed then it would have
  6042.     appeared in the main Auto Dialler menu, after all.)
  6043.  
  6044.     If you choose a directory with no associated Auto Dialler control file
  6045.     then a similar menu to the following one will appear;
  6046.  
  6047.       ┌────────────────────────────────────────────────────────────────┐
  6048.       │   MICROSOFT USA                 │ M0101 206 637 9009           │
  6049.       │   APOGEE BBS                    │ M0101 508 3659668            │
  6050.       │   WITCHITA STATE UNIVERSITY     │ M0101-316689-3779            │
  6051.       │   CREATIVE LABS (SOUNDBLASTER)  │ M0101 408 982-9226           │
  6052.       │   UNIVERSITY OF ARIZONA         │ M0101 602 621 2283           v
  6053.       └────────────────────────────────────────────────────────────────┘
  6054.  
  6055.      ╔═════════════════════════════════════════════════════════════════╗
  6056.      ║ You have selected a directory for which no auto dialler control ║
  6057.      ║  file exists. Using the space bar, select up to five entries to ║
  6058.      ║      be included in the control file. Press return when all     ║
  6059.      ║  selections are complete or press the escape key to abort this  ║
  6060.      ║                             process.                            ║
  6061.      ╚═════════════════════════════════════════════════════════════════╝
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.  
  6069.  
  6070.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 92
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.     As the directions in the box state, tag up to five entries you wish to
  6080.     be Auto Dialled from the scrolling list in the upper window. The small
  6081.     arrow in the right hand side of this window indicates that there are
  6082.     more entries below the last one you can see on the screen. If you tag
  6083.     more than five entries then (a) only the first five will be used and
  6084.     (b) you clearly have some advanced form of learning difficulty.
  6085.  
  6086.     Once you have tagged your entries, press return and you will be taken
  6087.     into the Auto Dialler control file editor. You will see something like
  6088.     this;
  6089.  
  6090.                        AUTO DIALLER CONTROL FILE SET UP
  6091.  
  6092.           Remote System                    Start   Stop    Max.
  6093.       ┌────────────────────────────────────────────────────────────────┐
  6094.       │  >MICROSOFT USA                    00:00   00:00   00:00<      │
  6095.       │   APOGEE BBS                       00:00   00:00   00:00       │
  6096.       │   WITCHITA STATE UNIVERSITY        00:00   00:00   00:00       │
  6097.       │   CREATIVE LABS (SOUNDBLASTER)     00:00   00:00   00:00       │
  6098.       │   UNIVERSITY OF ARIZONA            00:00   00:00   00:00       │
  6099.       └────────────────────────────────────────────────────────────────┘
  6100.           Select which entry you wish to edit. DEL deletes an entry,
  6101.                     RETURN selects an entry and ESC quits.
  6102.  
  6103.     Move the scroll bar down to the first entry you wish to edit and press
  6104.     return. The edit window will pop up in the lower half of the screen
  6105.     like this;
  6106.  
  6107.  
  6108.        ┌───────────────┤ EDIT ENTRY FOR MICROSOFT USA ├───────────────┐
  6109.        │                                                              │
  6110.        │                                        HR MIN                │
  6111.        │        TIME TO START DIALLING          00:00                 │
  6112.        │        TIME TO FINISH DIALLING         00:00                 │
  6113.        │        DURATION OF THIS CALL           00:00                 │
  6114.        │                                                              │
  6115.        └─────────────────┤ CURRENT TIME IS 02:41:56 ├─────────────────┘
  6116.  
  6117.                    Input start time hours (24 hour format)
  6118.                      F10 to accept entries, ESC to abort
  6119.  
  6120.     You will see six fields opposite the three titles on the screen. Into
  6121.     these fields enter the following information;
  6122.  
  6123.     Top left field     - The hour at which the Auto Dialler will start
  6124.                          dialling this system. (24 hour format)
  6125.     Top right field    - The minute at which the Auto Dialler will start
  6126.                          dialling this system.
  6127.     Centre left field  - The hour at which the Auto Dialler will stop
  6128.                          dialling this system if it couldn't get through.
  6129.                          (24 hour format)
  6130.     Centre right field - The minute at which the Auto Dialler will
  6131.                          stop dialling this system if it couldn't get
  6132.                          through.
  6133.  
  6134.  
  6135.  
  6136.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 93
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145.     Bottom left Field  - The number of hours of the maximum length of the
  6146.                          call. (24 hour format)
  6147.     Bottom right Field - The number of minutes of the maximum length of
  6148.                          the call.
  6149.  
  6150.     If you specify a maximum length of a call as being zero then PANTHER
  6151.     will revert to using its default call length of five minutes.
  6152.  
  6153.     So, for example, by filling in the fields with these numbers...
  6154.  
  6155.        ┌───────────────┤ EDIT ENTRY FOR MICROSOFT USA ├───────────────┐
  6156.        │                                                              │
  6157.        │                                        HR MIN                │
  6158.        │        TIME TO START DIALLING          03:45                 │
  6159.        │        TIME TO FINISH DIALLING         04:00                 │
  6160.        │        DURATION OF THIS CALL           ..:15                 │
  6161.        │                                                              │
  6162.        └─────────────────┤ CURRENT TIME IS 02:41:56 ├─────────────────┘
  6163.  
  6164.     ...you are saying 'start dialling for Microsoft BBS at 3:45 this
  6165.     morning and keep trying to get through until 4:00. If you get through
  6166.     then make sure this call lasts no longer than 15 minutes maximum.'
  6167.  
  6168.     Once you are happy with your times then press F10 and the entry in the
  6169.     upper window will be updated to reflect the times you have just input,
  6170.     thus;
  6171.  
  6172.           Remote System                    Start   Stop    Max.
  6173.       ┌────────────────────────────────────────────────────────────────┐
  6174.       │  >MICROSOFT USA                    03:45   04:00   00:15<      │
  6175.       │   APOGEE BBS                       00:00   00:00   00:00       │
  6176.       │   WITCHITA STATE UNIVERSITY        00:00   00:00   00:00       │
  6177.       │   CREATIVE LABS (SOUNDBLASTER)     00:00   00:00   00:00       │
  6178.       │   UNIVERSITY OF ARIZONA            00:00   00:00   00:00       │
  6179.       └────────────────────────────────────────────────────────────────┘
  6180.  
  6181.     Now carry on and edit the times for all your entries. If you decide
  6182.     that you don't want an entry included in the Auto Dialler session then
  6183.     simply highlight it in the top menu and press DEL. You can them remove
  6184.     that entry from the Auto Dialler Control file altogether and its name
  6185.     will be replaced in the top menu with the words '<BLANK ENTRY>'. If
  6186.     you then wish to place another system into this blank space then
  6187.     simply move down to the blank entry and press return on it. The list
  6188.     of systems will appear in the lower half of the screen from which you
  6189.     can select the entry you want. to include. Note that (for obvious
  6190.     reasons) you cannot tag multiple files here since you are only after
  6191.     one name and not five!
  6192.  
  6193.     Don't worry if the entries are not ordered chronologically. PANTHER
  6194.     sorts the list before saving it. Don't even worry if the times overlap
  6195.     slightly. PANTHER will only start dialling on or slightly after the
  6196.     specified times, adjusting the other times accordingly to suit.
  6197.  
  6198.  
  6199.  
  6200.  
  6201.  
  6202.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 94
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.  
  6209.  
  6210.  
  6211.     Once you have all the times as you wish, press escape and you will be
  6212.     asked if you want to save the entries to a control file. If you press
  6213.     'N' then the process will be aborted. If you press 'Y' then the Auto
  6214.     Dialler control file will be saved out to disk under the name
  6215.     DIRNAME.AUT, where DIRNAME is the name of the dialling directory used.
  6216.  
  6217.     When you go back to the main Auto Dialler menu you will find that your
  6218.     new Auto Dialler control file is now in the menu, like this;
  6219.  
  6220.             ┌───────────────────────────────────────────────────┐
  6221.             │                 AUTO DIALLER MENU                 │
  6222.             │           Select Choice or ESC to Quit            │
  6223.             │                                                   │
  6224.             │     >F1  Set Up Auto Dialler Control File         │
  6225.             │      F2  Auto Dial Using PANTHER Directory        │
  6226.             │      F3  Auto Dial Using STR_BEAN Directory       │
  6227.             │      F4  Auto Dial Using EUROPE Directory         │
  6228.             │      F5  Auto Dial Using FIDONET Directory        │
  6229.             │      F6  Auto Dial Using SUPPORT Directory        │
  6230.             │      F7  Auto Dial Using LONGDIST Directory       │
  6231.             │      F8  EXIT                                     │
  6232.             │                                                   │
  6233.             └───────────────────────────────────────────────────┘
  6234.  
  6235.     The menu will display up to the first twelve Auto Dialler control
  6236.     files it finds on the disk.
  6237.  
  6238.  
  6239.     STARTING AN AUTO DIALLER SESSION
  6240.     --------------------------------
  6241.  
  6242.     To start the Auto Dialler session you can do one of two things; you
  6243.     can either select the control file to be used from the above menu, or
  6244.     you can cause PANTHER to start straight up into an Auto Dialler
  6245.     session by starting it up with the command line switch
  6246.  
  6247.                          PANTHER AUTO=Autofile[.AUT]
  6248.  
  6249.     where 'Autofile' is replaced by the name of the control file you wish
  6250.     to use. The .AUT extension is not required but can be passed as
  6251.     appropriate.
  6252.  
  6253.     Whichever method you choose, the Auto Dialler session will commence.
  6254.  
  6255.     PANTHER will first attempt to detect whether or not you have a live
  6256.     and working modem attached to your serial port. If you don't then an
  6257.     error (error #10, to be exact) will flash on the screen and you will
  6258.     be sent back to the dialling directory. If you DO have a working modem
  6259.     on the serial port in question (and you have specified the correct
  6260.     port, of course!) and this error occurs then try restarting PANTHER
  6261.     with the /NOCHECKING command line switch. Auto checking like this does
  6262.     not work with all modems. See the errors section of this manual for
  6263.     more advice on this situation.
  6264.  
  6265.  
  6266.  
  6267.  
  6268.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 95
  6269.  
  6270.  
  6271.  
  6272.  
  6273.  
  6274.  
  6275.  
  6276.  
  6277.     If the modem detection did not report any errors you then will see a
  6278.     moving box on the screen containing details of the next connection to
  6279.     be made, something like this;
  6280.  
  6281.          ┌─────────────────────────────────────────────────────────┐
  6282.          │               THIS COMPUTER IS NOT IDLE!                │
  6283.          │   IT IS IN PANTHER AUTO DIAL MODE AND WILL CONNECT TO   │
  6284.          │                      MICROSOFT USA                      │
  6285.          │                        AT 03:45                         │
  6286.          │                The current time is 02:42                │
  6287.          │  PRESS ESC TO HALT, SPACE TO SKIP QUEUE TO NEXT ENTRY   │
  6288.          └─────────────────────────────────────────────────────────┘
  6289.  
  6290.     As the warning box says, if you press escape then you will abandon the
  6291.     entire Auto Dialler session. If, however, you press the space bar then
  6292.     you will only abort the current connection attempt. The Auto Dialler
  6293.     will then move onto the next (chronological) entry to be contacted.
  6294.  
  6295.     When any of the systems are eventually dialled, Auto Dialler will
  6296.     persist in getting through until the either it has succeeded or else
  6297.     the 'stop time' (as defined in the centre fields of the edit box) has
  6298.     been reached. If the latter then the Auto Dialler will move onto the
  6299.     next entry, if any. If the former, then the connection is made and the
  6300.     script file will assume control of the session.
  6301.  
  6302.     Bear in mind that during any connection you may intervene and press
  6303.     ALT-K to kill the current auto dialler session FOR THAT CONNECTION
  6304.     ONLY. Other further connection attempts will be made as normal through
  6305.     the Auto Dialler. Note that once the session has been killed in this
  6306.     manner, the script file running will not be terminated and will
  6307.     continue until aborted with the ALT-A keystroke. The reason for the
  6308.     ALT-K keystroke is this; if it is obvious that a script file is going
  6309.     awry or if you simply want to interrupt the script then aborting it
  6310.     with ALT-A will, during an Auto Dialler session, cause PANTHER to
  6311.     think that the script terminated prematurely and will drop carrier, as
  6312.     part of the inbuilt protection against Auto Dialler sessions leaving
  6313.     you on line for lengthy periods. By pressing ALT-K, this problem can
  6314.     be circumvented by simply telling PANTHER that the current connection
  6315.     must not be considered as an Auto Dialler connection. Please also be
  6316.     aware that 'smart scripts' will not operate during a 'killed' session.
  6317.  
  6318.     Once all connections have been made or attempted, a report will be
  6319.     written to the screen stating just what happened during that session.
  6320.     The report will look something like this;
  6321.  
  6322.     ╒═════════════════╣ RESULTS OF AUTO DIALLER SESSION ╠═════════════════╕
  6323.     │   MICROSOFT USA - Connected OK, directory updated                   │
  6324.     │   APOGEE BBS - Connected OK, directory not updated                  │
  6325.     │   WITCHITA STATE UNIVERSITY - Connected OK but script timed out     │
  6326.     │   CREATIVE LABS (SOUNDBLASTER) - Did not connect                    │
  6327.     │   UNIVERSITY OF ARIZONA - Did not connect, no script file           │
  6328.     ╘═════════════════════════════════════════════════════════════════════╛
  6329.  
  6330.  
  6331.  
  6332.  
  6333.  
  6334.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 96
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343.     The results have the following meanings;
  6344.  
  6345.     'No attempt made to connect' - You either pressed the escape key or
  6346.                    the space bar while the Auto Dialler was waiting to
  6347.                    dial this number, causing the number to be skipped.
  6348.  
  6349.     'Connected OK, directory updated' - The session was OK and PANTHER
  6350.                    managed to open the associated dialling directory and
  6351.                    update the number of calls made to the system and the
  6352.                    length of time spent on line.
  6353.  
  6354.     'Connected OK, directory not updated' - The session was OK but
  6355.                    PANTHER either could not find the associated dialling
  6356.                    directory (you might have deleted it) or else it found
  6357.                    the directory but could not locate an entry for the
  6358.                    system in it. (It might have been deleted from the
  6359.                    directory)
  6360.  
  6361.     'Connected OK but script timed out' - The connection was made OK but
  6362.                    the script file timed out when you were on line In
  6363.                    addition, the 'smart script' feature could not identify
  6364.                    how to fix the position with the script when it was
  6365.                    timing out. The session was most likely left
  6366.                    incomplete. Review the script file and make any changes
  6367.                    to it that will prevent time out.
  6368.  
  6369.     'Did not connect' - The connection could not be made. Either the line
  6370.                    was constantly engaged, the other modem would not
  6371.                    answer or the number has been disconnected. Check you
  6372.                    were dialling the right number!
  6373.  
  6374.     'Did not connect, no script file' - PANTHER didn't even attempt to
  6375.                    Auto Dial this number since it found no script file
  6376.                    associated with the dialling directory extract stored
  6377.                    in the Auto Dialler control file. To remedy this,
  6378.                    either learn or write the appropriate script file,
  6379.                    associate it with the system in the dialling directory,
  6380.                    test it and then edit the Auto Dialler control file.
  6381.                    You must then delete the entry for this system and then
  6382.                    reinstall it in the <BLANK ENTRY>. The reason for this
  6383.                    is that the Auto Dialler editor stores the entire
  6384.                    portion of the dialling directory when it is made, and
  6385.                    any updates made to the dialling directory will not be
  6386.                    made to the associated Auto Dialler control file.
  6387.  
  6388.     'Connected OK but max. time exceeded' - The connection was made OK but
  6389.                    the maximum connection time allowed was exceeded. It
  6390.                    may be that you did not allocate enough time for the
  6391.                    call. Although unlikely, it may also be that you have a
  6392.                    WAIT command (with no passed arguments) awaiting a
  6393.                    string from the remote system and Auto Dialler and
  6394.                    Script File time outs (set in the Program Settings
  6395.                    section) set to longer than the allowed duration of the
  6396.                    call.
  6397.  
  6398.  
  6399.  
  6400.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 97
  6401.  
  6402.  
  6403.  
  6404.  
  6405.  
  6406.  
  6407.  
  6408.  
  6409.     If you started from the DOS command line then PANTHER will halt at
  6410.     this point. If, however, the Auto Dialler session was invoked from the
  6411.     command line then you are invited to press any key to clear the report
  6412.     from the screen and return to the menu system.
  6413.  
  6414.  
  6415.  
  6416.  
  6417.  
  6418.  
  6419.  
  6420.  
  6421.  
  6422.  
  6423.  
  6424.  
  6425.  
  6426.  
  6427.  
  6428.  
  6429.  
  6430.  
  6431.  
  6432.  
  6433.  
  6434.  
  6435.  
  6436.  
  6437.  
  6438.  
  6439.  
  6440.  
  6441.  
  6442.  
  6443.  
  6444.  
  6445.  
  6446.  
  6447.  
  6448.  
  6449.  
  6450.  
  6451.  
  6452.  
  6453.  
  6454.  
  6455.  
  6456.  
  6457.  
  6458.  
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464.  
  6465.  
  6466.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 98
  6467.  
  6468.  
  6469.  
  6470.  
  6471.  
  6472.  
  6473.  
  6474.  
  6475.     TERMINAL MODE
  6476.     -------------
  6477.  
  6478.     Pressing F3 from the main menu will take you into PANTHER's terminal
  6479.     mode. This gives you the ability to send commands straight to your
  6480.     modem by typing them onto the screen and pressing return. This may be
  6481.     useful in running diagnostic checks on your modem or for temporarily
  6482.     setting PANTHER up to act as a host system by putting your modem into
  6483.     auto answer mode.
  6484.  
  6485.     When starting up terminal mode, PANTHER will first attempt to detect
  6486.     whether or not you have a live and working modem attached to your
  6487.     serial port. If you don't then an error (error #10, to be exact) will
  6488.     flash on the screen and you will be sent back to the main menu. If you
  6489.     DO have a working modem on the serial port in question (and you have
  6490.     specified the correct port, of course!) and this error occurs then try
  6491.     restarting PANTHER with the /NOCHECKING command line switch. Auto
  6492.     checking like this does not work with all modems. See the errors
  6493.     section of this manual for more advice on this situation.
  6494.  
  6495.     The next thing to happen is that PANTHER will check for the presence
  6496.     of a resident Fossil driver. If it finds that a Fossil driver has been
  6497.     loaded then an error stating that it is initialising the port, but
  6498.     that it has detected the driver and (hence) the port may not be
  6499.     initialised as you expect. Occasionally, a resident fossil will hold
  6500.     the baud rate of the port to that which it has been set and will not
  6501.     allow further initialisation of the port to proceed. However, this
  6502.     error will only flag the presence of the Fossil driver - it will not
  6503.     prevent the port initialisation from proceeding.
  6504.  
  6505.     After this, PANTHER will attempt to detect and disable FIFO buffering
  6506.     found in 16550A UART chips, on the selected serial port. If the
  6507.     buffering is left active then PANTHER will not be able to initialise
  6508.     the port at all. After this, the port will be initialised using the
  6509.     required baud, parity, stop and data bits, following which FIFO
  6510.     buffering will be re-enabled.
  6511.  
  6512.     Assuming that no problems arise with the modem detection, PANTHER then
  6513.     initialises your serial port with the default settings you have
  6514.     specified in the Directory Defaults section of the configuration menu.
  6515.     Once the serial port has been initialised then the screen is cleared
  6516.     and the cursor is positioned in the top left of the screen. From now
  6517.     on, any characters you type will be cumulatively added together until
  6518.     you press return, at which point all the characters will be set to the
  6519.     modem, together with a return character.
  6520.  
  6521.  
  6522.  
  6523.  
  6524.  
  6525.  
  6526.  
  6527.  
  6528.  
  6529.  
  6530.  
  6531.  
  6532.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 99
  6533.  
  6534.  
  6535.  
  6536.  
  6537.  
  6538.  
  6539.  
  6540.  
  6541.     There are several special keystrokes which you can use in terminal
  6542.     mode when NOT on line (ie connected to another modem). These are;
  6543.  
  6544.     ALT-C   Change the capture file status. If a capture file is not
  6545.             running then you will be asked if you want to start
  6546.             one. If you reply that you do then you will be prompted for the
  6547.             name of the capture file to create. If that file already
  6548.             exists then it will be appended to, if it doesn't exist then it
  6549.             will be created.This file name defaults to PANTHER.CAP. If a
  6550.             capture file is running then you will be asked whether you want
  6551.             to stop it or to suspend it temporarily. If a capture file has
  6552.             been suspended then you will be asked whether you want to
  6553.             reactivate it or not. In any event, the keys to press in
  6554.             response are shown in brackets in the information box that
  6555.             appears on pressing this keystroke.
  6556.  
  6557.     ALT-D   Shell to DOS temporarily. The screen will clear and you will
  6558.             find yourself in a DOS session. To re-enter PANTHER, type EXIT
  6559.             <return> at the DOS prompt and you will find yourself at
  6560.             exactly the same position you were in before you shelled out.
  6561.  
  6562.     ALT-M   Modify the display type. This will pop up a small box asking
  6563.             you which of Teletype or ANSI terminal emulation you require.
  6564.             Pressing the initial letter of the display type (either T or A)
  6565.             will invoke that particular terminal emulation type.
  6566.  
  6567.     ALT-P   Toggles printer capture on or off.
  6568.  
  6569.     ALT-S   Take a snapshot of the current screen. The entire contents of
  6570.             the screen (but not the status line) will be captured and
  6571.             stored in the PANTHER.SNP snapshot file.
  6572.  
  6573.     ALT-T   Toggles destructive backspace on and off.
  6574.  
  6575.     ALT-V   Allows you to view the internal scrollback buffer.
  6576.  
  6577.     ALT-Y   Allows you to edit the internal filelist
  6578.  
  6579.     F1      Shows a summarised help screen.
  6580.  
  6581.     F2      Shows a summary of all the keystroke macros you have defined.
  6582.  
  6583.     F3      Recalls and sends the last string sent to your modem.
  6584.  
  6585.     F4      Sends your modem reset string (as defined in the modem strings
  6586.             section of the configuration menu) to the modem.
  6587.  
  6588.     F5      Sends your modem initialisation string (as defined in the
  6589.             modem strings section of the configuration menu) to the modem.
  6590.  
  6591.     F6      Sends your Mercury Personal Identification Number (as defined
  6592.             in the modem strings section of the configuration menu, if
  6593.             defined at all) to the modem.
  6594.  
  6595.     F7      Clears the screen.
  6596.  
  6597.  
  6598.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 100
  6599.  
  6600.  
  6601.  
  6602.  
  6603.  
  6604.  
  6605.  
  6606.  
  6607.     When on-line within terminal mode, all these keystrokes (apart from
  6608.     those defined by F3, F4, F5, F6 and F7) are available as well as the
  6609.     following; ALT-B, ALT-E, ALT-G, ALT-H, ALT-L, ALT-M, ALT-N, ALT-R,
  6610.     ALT-X, ALT-=, PageUp and PageDn
  6611.  
  6612.     All these keystrokes have the same meaning as those when connected on
  6613.     line from the dialling directory. When going on line with PANTHER,
  6614.     your connect string (if any) is shown on the screen and the status bar
  6615.     changes to that similar to that when connected from the dialling
  6616.     directory.
  6617.  
  6618.     When a connection is terminated from the terminal mode then it will be
  6619.     returned to its off line mode again. To quit from the off line
  6620.     terminal mode, press escape. You will be returned to the main menu.
  6621.  
  6622.  
  6623.     AUTO ANSWERING
  6624.     --------------
  6625.  
  6626.     PANTHER is not primarily intended to be used as a host system, but if
  6627.     necessary (and if your modem can support it) it can be set up to
  6628.     receive incoming calls. If you are using a Hayes-compatible modem,
  6629.     this is usually enabled by sending the command
  6630.  
  6631.                                ATS0=[n]<return>
  6632.  
  6633.     to your modem, where [n] is a non-zero number representing the number
  6634.     of times your modem will allow the phone to ring before picking the
  6635.     line up. If you are not using a Hayes compatible modem then you will
  6636.     have to refer to your modem manual to obtain the correct string.
  6637.  
  6638.     When an incoming call is received, PANTHER checks to see whether the
  6639.     modem is in auto answer mode or not. If it is, and a carrier is
  6640.     obtained, the connect string is displayed on the screen with the
  6641.     connection melody. The name of the remote system on the status line
  6642.     becomes AUTO ANSWER MODE. Notice that you will have to enable local
  6643.     echo and line feeds before you can see what you are typing on the
  6644.     screen when connected, if they are not set up by default.
  6645.  
  6646.     To disconnect the link, press ALT-H to hang up the line and drop
  6647.     carrier. You will then be returned to the terminal mode off line. It
  6648.     might be a good idea to enter your modem's RESET string at this point
  6649.     to disable the auto answer facility, then press escape to return to
  6650.     the main menu.
  6651.  
  6652.  
  6653.  
  6654.  
  6655.  
  6656.  
  6657.  
  6658.  
  6659.  
  6660.  
  6661.  
  6662.  
  6663.  
  6664.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 101
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670.  
  6671.  
  6672.  
  6673.     ANCILLARY FILES
  6674.     ---------------
  6675.  
  6676.     PANTHER creates numerous files as and when (or if) it requires. This
  6677.     short section deals with these files and describes their structure.
  6678.  
  6679.  
  6680.     THE LOG FILE (PANTHER.LOG)
  6681.     --------------------------
  6682.  
  6683.     The PANTHER log file holds details of every connection you make. Here
  6684.     is an example extract from it;
  6685.  
  6686.     19:54:02 │ Saturday February 29, 1992
  6687.              │ AUTO DIALLER SESSION
  6688.              │ Connected To MENTAL FRANKIE'S BBS          (Using MERCURY)
  6689.              │ Baud 2400
  6690.              │ Minimum connect speed of 9600 baud not reached.
  6691.              │ Capture file for new system : FRANKIE.CAP Opened.
  6692.              │ Learning Script file : FRANKIE.SPT
  6693.              │ NOTE: Password chosen as IWANNA16550
  6694.              │ WARNING : Unexpected prompt received, at script line
  6695.              │           number 16. Smart script interpreter enabled.
  6696.              │ Extended keystrokes disabled.
  6697.              │ Extended keystrokes re-enabled.
  6698.              │ Shelled to DOS.
  6699.              │ Returned from DOS.
  6700.              │ Capture file suspended.
  6701.              │ - Download [MAILBAG.ZIP]
  6702.              │ + Upload [PANTHER.ZIP]
  6703.              │ PANTHER.ZIP deleted
  6704.              │ Capture file reactivated.
  6705.              │ Script file : FRANKIE.SPT closed by PANTHER.
  6706.              │ Capture file Closed by PANTHER.
  6707.     19:56:22 │ Alt H used to terminate session.
  6708.              │ Time Connected 00:02:20
  6709.  
  6710.     Obviously this is not intended to be a realistic example! There is no
  6711.     way that you could have managed to start up Auto Dialler without a
  6712.     script file, for instance, but this is only intended to give you an
  6713.     idea as to what to expect in a log file entry. Auto dialler or auto
  6714.     answer sessions are flagged as being such by heading the entry with a
  6715.     note in capital letters. The name of the remote system will then be
  6716.     shown together with the connect speed. The next line is what would
  6717.     appear in the log file should the MINIMUM SPEED directive of the
  6718.     script facility not be reached. Under normal circumstances, this would
  6719.     result in the call being terminated. Since the user has never called
  6720.     this system before, PANTHER is offering to automatically open a
  6721.     capture file for him, which he has accepted. We then get an indication
  6722.     that a script file is being automatically learned by PANTHER. After
  6723.     that, a (rather unlikely) note has been tacked into the log file by
  6724.     the user pressing ALT-N when on line.
  6725.  
  6726.  
  6727.  
  6728.  
  6729.  
  6730.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 102
  6731.  
  6732.  
  6733.  
  6734.  
  6735.  
  6736.  
  6737.  
  6738.  
  6739.     The line starting with 'WARNING' is what will occur should the 'smart
  6740.     script' facility come into play. The offending line of the script file
  6741.     is also indicated. Note that the line mentioned contains the 'RECEIVE'
  6742.     prompt that was NOT received in time. The user then disabled all
  6743.     extended keystrokes with ALT-= and then re-enabled them with ALT-=
  6744.     again. He then shelled out to DOS and then returned, followed by him
  6745.     suspending the capture file from running.
  6746.  
  6747.     He then downloaded a mailbag and (sensible fellow) uploaded
  6748.     PANTHER.ZIP to the system. This file matched the file masks in the
  6749.     mail files configuration so it was deleted. He then reactivated the
  6750.     capture file from its suspended state.
  6751.  
  6752.     After this, he terminated the connection causing the script and
  6753.     capture files to be closed automatically by PANTHER. An indication as
  6754.     to how his call was terminated was given (ALT-H? Tsk, tsk, tsk...) and
  6755.     his log off time and total connection times are shown.
  6756.  
  6757.  
  6758.     THE ERROR FILE (PANTHER.ERF)
  6759.     ----------------------------
  6760.  
  6761.     This file holds a record of all the errors that appear within PANTHER.
  6762.     This may be useful to you since you may miss any errors which occur,
  6763.     so a permanent record of them is held.
  6764.  
  6765.     This is a simple text file of the following format;
  6766.  
  6767.               <DATE>  <TIME> ERROR #<NUMBER> - <ERROR MESSSAGE>
  6768.  
  6769.  
  6770.     THE CAPTURE FILE (USER-DEFINABLE NAMES)
  6771.     ---------------------------------------
  6772.  
  6773.     This contains a straight 'capture' of all text that has appeared on
  6774.     your screen between the times the capture file is invoked and either
  6775.     the time you close it or when you log off. One thing, though. If a
  6776.     system is using ANSI escape codes to draw fancy menus or logos and
  6777.     thereby move the cursor in a non-standard way (ie, not from left to
  6778.     right and from top to bottom) then there is a good chance the capture
  6779.     file will be jumbled at this point. Unavoidable, we are afraid! The
  6780.     points at which the capture file is either suspended, closed or
  6781.     appended are marked with a dashed line.
  6782.  
  6783.  
  6784.     THE TEXT SNAPSHOT FILE (PANTHER.SNP)
  6785.     ------------------------------------
  6786.  
  6787.     This is almost exactly like the capture file except that all captures
  6788.     are made at the time across the screen so even fancy ANSI screens are
  6789.     captured properly. Each snapshot is separated with a dashed line.
  6790.  
  6791.  
  6792.  
  6793.  
  6794.  
  6795.  
  6796.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 103
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.     THE RAW LOG FILE(S) (RAWLOG.*)
  6806.     ------------------------------
  6807.  
  6808.     These are files comprising of every character received by your modem
  6809.     while raw logging is enabled, text, control codes, the lot. You can
  6810.     view the TTY raw log (RAWLOG.TXT) with any file viewer, text editor or
  6811.     ever the internal DOS TYPE command, as it only contains bare text.
  6812.     (Incidentally, if you find that it doesn't then you have probably
  6813.     inadvertently set PANTHER to use TTY emulation when the remote system
  6814.     was sending something else.)
  6815.  
  6816.     The ANSI (RAWLOG.ANS) and Avatar (RAWLOG.AVT) files can be viewed
  6817.     using the DOS TYPE command as long as the appropriate DOS device
  6818.     drivers (ANSI.SYS, AVATAR.SYS or some other derivatives) are loaded
  6819.     first. You'll probably find it easier to view these through the
  6820.     internal raw log file viewer, accessed from the main menu.
  6821.  
  6822.     The VT52 files (RAWLOG.V52) can only really be adequately viewed
  6823.     through the internal viewer as there is relatively little PC-based
  6824.     support for this terminal emulation.
  6825.  
  6826.  
  6827.     THE COLOUR SNAPSHOT FILE (PANTHER.BIN)
  6828.     --------------------------------------
  6829.  
  6830.     This file contains your colour snapshots appended to one another, all
  6831.     stored using the standard binary format, saved from left to right and
  6832.     top to bottom as character/attribute. The file ought always to be an
  6833.     exact multiple of 4000 in size. (80 x 25 x 2 - even if you are in 24
  6834.     line mode, PANTHER merely stores the 25th line as a series of
  6835.     'blanks')
  6836.  
  6837.     If you save *.BIN files from the colour snapshot viewer then these
  6838.     will be in exactly the same standard format. This format is readable
  6839.     by most ANSI editors, such as TheDraw.
  6840.  
  6841.     THE 'RUNNING' FILE (PANTHER.RUN)
  6842.     --------------------------------
  6843.  
  6844.     This file only signifies that PANTHER is running. It is deleted when
  6845.     you quit from PANTHER - in other words, don't touch it!
  6846.  
  6847.  
  6848.  
  6849.  
  6850.  
  6851.  
  6852.  
  6853.  
  6854.  
  6855.  
  6856.  
  6857.  
  6858.  
  6859.  
  6860.  
  6861.  
  6862.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 104
  6863.  
  6864.  
  6865.  
  6866.  
  6867.  
  6868.  
  6869.  
  6870.  
  6871.     ABOUT THE DEVELOPMENT OF PANTHER
  6872.     --------------------------------
  6873.  
  6874.     PANTHER was written simply because I never found a comms program that
  6875.     met all my needs. There are many on the market, but I found them
  6876.     either to cumbersome or too simplistic, hence PANTHER. Version 2.0
  6877.     features some of the things that my users had specifically requested
  6878.     after having run version 1.42.
  6879.  
  6880.     PANTHER comprises of 48808 lines of code written in Borland Pascal
  6881.     using version 7.0 of the compiler. It was debugged under Borland Turbo
  6882.     Debugger and streamlined using Borland Turbo Profiler. Certain other
  6883.     portions of the work were written and compiled under Borland Turbo
  6884.     Assembler. All development work was made under OS/2 2.0.
  6885.  
  6886.     This manual was composed using Buttonware's PC-TYPE.
  6887.  
  6888.  
  6889.  
  6890.  
  6891.  
  6892.  
  6893.  
  6894.  
  6895.  
  6896.  
  6897.  
  6898.  
  6899.  
  6900.  
  6901.  
  6902.  
  6903.  
  6904.  
  6905.  
  6906.  
  6907.  
  6908.  
  6909.  
  6910.  
  6911.  
  6912.  
  6913.  
  6914.  
  6915.  
  6916.  
  6917.  
  6918.  
  6919.  
  6920.  
  6921.  
  6922.  
  6923.  
  6924.  
  6925.  
  6926.  
  6927.  
  6928.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 105
  6929.  
  6930.  
  6931.  
  6932.  
  6933.  
  6934.  
  6935.  
  6936.  
  6937.     TROUBLESHOOTING
  6938.     ---------------
  6939.  
  6940.     As PC communications is an area of computing more liable to the
  6941.     vagaries of hardware and installed software, you may experience some
  6942.     problems in running PANTHER. Here are some of the more common problems
  6943.     and their remedies;
  6944.  
  6945.     - Immediately on entering terminal mode, the connect tone (if set)
  6946.       sounds and the status line shows a connection.
  6947.  
  6948.       You have probably enabled the carrier override on your modem.
  6949.       PANTHER requires the carrier detect to be false when not connected
  6950.       to another computer and on when it is. Since your modem has been set
  6951.       to automatically provide a carrier, PANTHER assumes it is connected
  6952.       as soon as it enters terminal mode. If your modem has DIP switches,
  6953.       check their setting to ensure the carrier detect switch is set to
  6954.       off. If the modem does not have such switches then it will probably
  6955.       require particular commands to be sent to it (within the
  6956.       initialisation string set up in the modem strings section) to disable
  6957.       the automatic carrier.
  6958.  
  6959.     - On entering terminal mode or on commencing dialling, you receive a
  6960.       message stating that PANTHER cannot initialise the COM port.
  6961.  
  6962.       In the Ports section of the configuration, PANTHER detects how many
  6963.       serial ports you have and only offers you the choice of the existing
  6964.       ports. However, it may be that you have a non-standard set up and
  6965.       that PANTHER has offered you the choice of more serial ports than
  6966.       your machine physically has. If you select one of these ports then
  6967.       PANTHER will not be able to initialise that port.
  6968.  
  6969.     - You can initialise the serial port but on checking the set baud rate
  6970.       (by an internal modem diagnostic command, for example) it has not
  6971.       been set in accordance with your command.
  6972.  
  6973.       It is possible that you have a resident Fossil driver installed which
  6974.       is set up to lock your serial port at a particular baud rate. Since
  6975.       Fossil drivers hook into DOS interrupt 14h (Serial Port Services),
  6976.       further 'conventional' attempts to access the port will be ignored.
  6977.       Either reinstall the Fossil with the settings you will be using or
  6978.       (more preferably, if possible) deinstall the Fossil driver altogether
  6979.       when running PANTHER.
  6980.  
  6981.  
  6982.  
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.  
  6989.  
  6990.  
  6991.  
  6992.  
  6993.  
  6994.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 106
  6995.  
  6996.  
  6997.  
  6998.  
  6999.  
  7000.  
  7001.  
  7002.  
  7003.     - Your modem refuses to drop the carrier when you hang up the modem.
  7004.  
  7005.       When PANTHER disconnects your modem, it will first of all try to
  7006.       lower the DTR on your serial port in an effort to drop the carrier.
  7007.       This ought to work with most modems, but some will not respond to
  7008.       this. In order to overcome this, PANTHER will then, if a carrier
  7009.       signal remains, send the hang up string you have specified to the
  7010.       modem. If this fails then either you have specified the wrong hang up
  7011.       string for your modem (bear in mind that some hang up strings require
  7012.       pauses embedded in them to work) or you have probably enabled the
  7013.       carrier override on your modem. If this is enabled then any attempt
  7014.       to either lower the DTR or hang up the modem by a command string will
  7015.       fail since your modem is generating the carrier signal. If your modem
  7016.       has DIP switches, check their setting to ensure the carrier detect
  7017.       switch is set to off. If the modem does not have such switches then
  7018.       it will probably require particular commands to be sent to it (within
  7019.       the initialisation string set up in the modem strings section) to
  7020.       disable the automatic carrier. PANTHER will attempt to send the hang
  7021.       up string to your modem up to ten times before telling you that the
  7022.       hang up failed. If the error appears then it is most likely that the
  7023.       carrier override facility in your modem has been enabled.
  7024.  
  7025.     - When dialling through the dialling directory, PANTHER doesn't stop
  7026.       dialling on an engaged line until the dialling time on the status
  7027.       bar has reached zero.
  7028.  
  7029.       In order for PANTHER to know when a line is engaged or otherwise
  7030.       unavailable, you must specify the strings your modem returns in the
  7031.       busy strings section of the modem strings configuration. If you have
  7032.       not specified all the strings your modem returns on a failed
  7033.       connection, then do so. If you have then it may be that you have not
  7034.       specified a high enough 'X' code in your initialisation string in
  7035.       order to return all the strings. In general, set the 'X' code to be
  7036.       as high as the modem will accept. Consult your modem manual for
  7037.       information as to what strings it returns and what the maximum 'X'
  7038.       code it can take is.
  7039.  
  7040.     - Some capture files seem to contain the correct characters but in the
  7041.       wrong sequence.
  7042.  
  7043.       This is probably because the screen you were viewing at the time was
  7044.       an animated ANSI editor which positions the cursor and characters at
  7045.       non-sequential positions on the screen. There isn't much you can do
  7046.       with this, since PANTHER processes capture files directly from the
  7047.       serial port and not from the screen.
  7048.  
  7049.     - On starting up terminal mode, Auto Dialler or commencing dialling
  7050.       from the directory, you receive an error message informing you that
  7051.       there is no modem attached to your serial port.
  7052.  
  7053.  
  7054.  
  7055.  
  7056.  
  7057.  
  7058.  
  7059.  
  7060.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 107
  7061.  
  7062.  
  7063.  
  7064.  
  7065.  
  7066.  
  7067.  
  7068.  
  7069.       When starting up in these modes, PANTHER will first attempt to
  7070.       detect whether or not you have a live and working modem attached to
  7071.       your serial port. If you don't then an error will flash on the screen
  7072.       and you will be sent back to the main menu. If you DO have a working
  7073.       modem on the serial port in question then try restarting PANTHER
  7074.       with the /NOCHECKING command line switch. Auto checking like this
  7075.       does not work with all modems and can sometimes fail under
  7076.       multitasking systems like Microsoft Windows.
  7077.  
  7078.     - Learned script files don't work as you'd expect.
  7079.  
  7080.       The problem here is probably that the script file is waiting for a
  7081.       prompt that will never arrive. The greatest possibility here is that
  7082.       the prompt is somehow 'animated' and that PANTHER is not
  7083.       interpreting it correctly. For example, in the following instance
  7084.  
  7085.                          Is your name JOE BLOGGS? (Y)
  7086.  
  7087.       you may find that the cursor is sitting under the 'Y' character
  7088.       having been backtracked by ANSI escape sequences from the end of the
  7089.       line. At the moment, PANTHER cannot handle this kind of prompt
  7090.       properly. It doesn't occur very often, but when it does it will halt
  7091.       the script. Your best bet here is to reduce the above RECEIVE prompt
  7092.       down to a simple
  7093.  
  7094.                       RECEIVE "Is your name JOE BLOGGS?"
  7095.  
  7096.       thereby getting around the 'animated' section of the prompt.
  7097.  
  7098.     - Pressing ESCAPE to halt dialling from the dialling directory quits
  7099.       back to the dialling directory but the dialling continues.
  7100.  
  7101.       When cancelling dialling in this manner, PANTHER will (among other
  7102.       things) send your 'reset modem' string to the serial port. Now some
  7103.       modems may also require to be put into 'command mode' prior to
  7104.       receiving this string. If you find that pressing escape whilst
  7105.       dialling leaves a dialling tone (or even leaves the modem dialling)
  7106.       then precede your 'reset modem' string with your modem's escape code
  7107.       sequence. In the case of Hayes compatible modems this will mean
  7108.       changing your 'reset modem' string from 'ATZ^M' to '+++ATZ^M'
  7109.  
  7110.     - When shelling to DOS and returning to PANTHER whilst on line, part
  7111.       or all of the text received in that interim period has been lost.
  7112.  
  7113.       This is because of the fact that PANTHER is both interrupt driven
  7114.       and swaps itself out to XMS, EMS or disk file whilst shelling out.
  7115.       As a result, hardly any active portion of PANTHER is left in RAM
  7116.       to operate. The trick here is not to shell out whilst there is text
  7117.       being received when on line!
  7118.  
  7119.  
  7120.  
  7121.  
  7122.  
  7123.  
  7124.  
  7125.  
  7126.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 108
  7127.  
  7128.  
  7129.  
  7130.  
  7131.  
  7132.  
  7133.  
  7134.  
  7135.     - When running PANTHER under OS/2 2.0 you find that you lose
  7136.       occasional characters and that file transfers are error-prone.
  7137.  
  7138.       The trick here is to reduce the baud rate you set your serial port at
  7139.       in the dialling directory. If you are setting your serial port to a
  7140.       high speed of 38400 or 57600 baud then you will find problems as OS/2
  7141.       cannot handle as many interrupts as PANTHER will be generating.
  7142.       Lowering the baud rate to 19200 will solve this problem, as will
  7143.       obtaining alternative COM drivers from IBM. Some third party COM
  7144.       drivers are also available. Worth a specific mention are SIO.SYS and
  7145.       VSIO.SYS written by Raymond L. Gwinn which have the ability (among
  7146.       other things) to emulate a 16550AFN UART even if you don't have the
  7147.       hardware for it.
  7148.  
  7149.     - You get the initial warning about PANTHER detecting a carrier
  7150.       signal, even although you are sure your modem isn't returning one.
  7151.  
  7152.       Have you selected the correct serial port? It could be that you've
  7153.       accidentally selected your mouse port instead, which will return a
  7154.       high carrier signal!
  7155.  
  7156.       Alternatively., it *might* be returning a carrier signal because
  7157.       your modem is designed to default to that but can be configured not
  7158.       to. The specified commands for setting the carrier detect operations
  7159.       vary from modem to modem, but set it to normal carrier detect
  7160.       operations rather than any setting which overrides the carrier
  7161.       detection.
  7162.  
  7163.     - When you issue a KEYS macro on the command line, PANTHER doesn't
  7164.       appear to use them. After running PANTHER I get one or more 'Bad
  7165.       Command of Filename' errors from DOS.
  7166.  
  7167.       This will only generally happen if you are running JP Software's
  7168.       (superb) replacement for COMMAND.COM called 4DOS. 4DOS allows you to
  7169.       stack multiple command commands on one command line, separated by a
  7170.       specific character. By default, this character is a caret (^) symbol,
  7171.       which of course PANTHER uses to show control characters. Hence, if
  7172.       you issue a command line macro of two return characters as in
  7173.       KEYS=^M^M then 4DOS will read as far as the first caret then assume
  7174.       the following characters are distinct commands, separated by a caret
  7175.       symbol. To get round this problem, you can (only if you use 4DOS) use
  7176.       the asterisk (*) character instead of the caret symbol, making the
  7177.       parameters KEYS=*M*M, which 4DOS will read correctly.
  7178.  
  7179.     - When dialling from the dialling directory you find that the dialling
  7180.       timer only starts when the modem signal is returned rather than when
  7181.       the dialling commences.
  7182.  
  7183.       You've almost certainly got your modem set up not to echo commands.
  7184.       To enable this (and it really ought to be) include the modem command
  7185.       E1 in your initialisation string.
  7186.  
  7187.  
  7188.  
  7189.  
  7190.  
  7191.  
  7192.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 109
  7193.  
  7194.  
  7195.  
  7196.  
  7197.  
  7198.  
  7199.  
  7200.  
  7201.     PANTHER ERROR MESSAGES
  7202.     ----------------------
  7203.  
  7204.     From time to time, things go wrong. <sigh> When they go wrong within
  7205.     PANTHER, you will get a nice big (and hopefully helpful) error box
  7206.     plastered over the screen which will carry on it a numbered error
  7207.     message telling you exactly WHAT has gone wrong and where.
  7208.  
  7209.     All errors are displayed on the screen and are also written out into
  7210.     the PANTHER.ERF error message file, in case you missed them.
  7211.  
  7212.     Incidentally, most of the file errors ought not to occur. PANTHER
  7213.     automatically sets the attributes of all its support files to Archive
  7214.     when starting up.
  7215.  
  7216.  
  7217.     INTERNAL PROTOCOL ERRORS
  7218.     ------------------------
  7219.  
  7220.     PANTHER's internal protocols return error codes if things go astray
  7221.     during their execution. These errors are returned as four digit
  7222.     numbers of the form 99xx and mean the following;
  7223.  
  7224.     9900 - Xmodem initialisation failed.
  7225.     9901 - Xmodem initialisation was cancelled.
  7226.     9902 - Transfer aborted. (You pressed escape during the transfer)
  7227.     9903 - A duplicate block was received.
  7228.     9904 - Wrong block number was received.
  7229.     9905 - You specified a directory when sending a file but that
  7230.            directory doesn't exist.
  7231.     9906 - Could not find file to send.
  7232.     9907 - Long packet received during protocol.
  7233.     9908 - End of transmitted file.
  7234.     9909 - Initial protocol handshake in progress.
  7235.     9910 - Incoming file was renamed.
  7236.     9911 - Incoming file already exists.
  7237.     9912 - Ymodem header has a bad (or incorrect) file size.
  7238.     9913 - Ymodem header has a bad (or incorrect) date or time stamp.
  7239.     9914 - Unexpected character during protocol transfer. (You might be
  7240.            using a different protocol from the remote system if you get
  7241.            this one)
  7242.     9915 - Incorrect CRC or checksum received.
  7243.     9916 - No files specified for transmission.
  7244.     9917 - No file name specified during Xmodem download.
  7245.     9918 - [Reserved]
  7246.     9919 - Receiver rejected file.
  7247.     9920-9924 - [Reserved]
  7248.     9925 - Zmodem - got CcrE DataSubpacket.
  7249.     9926 - Zmodem - got CcrW DataSubpacket.
  7250.     9927 - Zmodem - got CcrQ DataSubpacket.
  7251.     9928 - Zmodem - got CcrG DataSubpacket.
  7252.     9929 - Zmodem - got garbage from remote.
  7253.     9930 - Zmodem - skip file.
  7254.     9931 - Zmodem - bad file position.
  7255.  
  7256.  
  7257.  
  7258.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 110
  7259.  
  7260.  
  7261.  
  7262.  
  7263.  
  7264.  
  7265.  
  7266.  
  7267.     9932 - Zmodem - specified file doesn't exist.
  7268.     9933 - Zmodem - not allowed to overwrite file.
  7269.  
  7270.     Not all of the above errors will ever be generated by PANTHER, but
  7271.     they are all reproduced here for completion.
  7272.  
  7273.  
  7274.     FATAL ERRORS
  7275.     ------------
  7276.  
  7277.     Some errors are so bad that they force PANTHER to stop in its tracks!
  7278.     These errors are displayed as follows;
  7279.  
  7280.     Message : PANTHER.EXE HAS BEEN ILLEGALLY ALTERED - PROGRAM ABORTING
  7281.     Meaning : PANTHER isn't quite what it used to be.
  7282.     Remedy  : When PANTHER starts up it examines itself to ensure that
  7283.               the PANTHER.EXE program has not been altered in any way. If
  7284.               it has then this error appears and everything stops. To
  7285.               remedy this, delete PANTHER.EXE and reinstall it from a
  7286.               back up. Oh yes, and stop messing about with it!
  7287.  
  7288.     Message : CONFIGURATION FILE CORRUPTED! RESTART PANTHER!
  7289.     Meaning : The file PANTHER.CFG has become seriously corrupted.
  7290.     Remedy  : Restart PANTHER. This error should only ever occur if the
  7291.               configuration file becomes corrupted between PANTHER
  7292.               reading it when it starts up and some other point within the
  7293.               program's execution. By restarting PANTHER, the program
  7294.               will handle the corruption and will reconstruct the file
  7295.               with defaults which it will allow you to edit.
  7296.  
  7297.     Message : CANNOT READ DIRECTORY! ABORTING PROGRAM!
  7298.     Meaning : Whichever directory you are starting PANTHER up with, it
  7299.               has become unreadable.
  7300.     Remedy  : Restart PANTHER with the /DIR switch, specifying another
  7301.               dialling directory. Delete the offending directory from your
  7302.               disk and restore it from a back up. You do have back ups,
  7303.               don't you?
  7304.  
  7305.     Message : CANNOT AUTO DIAL AS CONTROL FILE DOES NOT EXIST!
  7306.     Meaning : You've tried to start Auto Dialling on a non-existent
  7307.               control file!
  7308.     Remedy  : You have started up PANTHER from the command line with the
  7309.               /AUTO switch and specified a-non existent control file name.
  7310.               Simply restart PANTHER with a file name that exists.
  7311.               This is identical to error #27 listed below but will
  7312.               only be displayed if your are Auto Dialling from the DOS
  7313.               command line with the /AUTO switch.
  7314.  
  7315.  
  7316.  
  7317.  
  7318.  
  7319.  
  7320.  
  7321.  
  7322.  
  7323.  
  7324.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 111
  7325.  
  7326.  
  7327.  
  7328.  
  7329.  
  7330.  
  7331.  
  7332.  
  7333.     Message : AUTO DIALLING TERMINATED - DIRECTORY NOT FOUND!
  7334.     Meaning : You've tried to start Auto Dialling on a non-existent
  7335.               dialling directory, probably as a result of setting up the
  7336.               Auto Dialler control file and then either deleting or
  7337.               renaming its associated dialling directory.
  7338.     Remedy  : If you've just renamed the directory then rename it back! If
  7339.               you've deleted it then undelete it (if you can) or delete
  7340.               the Auto Dialler control file and start again.
  7341.  
  7342.     The only other mega-scary fatal error you will ever get from PANTHER
  7343.     is an internal failure error which displays itself as 'SYSTEM ERROR AT
  7344.     <numbers> ERROR CODE = <number>'. We have hopefully ironed out all the
  7345.     bugs from PANTHER so that you will never see this error. However, if
  7346.     you do then note the numbers and contact the programmers on the BBS
  7347.     listed in the READ.ME file.
  7348.  
  7349.  
  7350.     NON-FATAL ERRORS
  7351.     ----------------
  7352.  
  7353.     These are the other errors that PANTHER generates, together with their
  7354.     listed numbers (fatal errors are given the nominal error value of 1),
  7355.     their meanings and the remedy. Words in <angled brackets> signify that
  7356.     the error message will incorporate a some variable element.
  7357.  
  7358.     Message : SCRIPT FILE TIME OUT! - SCRIPT FILE ABORTED!
  7359.     Number  : 2
  7360.     Meaning : The script file you are running has not received the string
  7361.               it is expecting within the default time out period.
  7362.     Remedy  : Examine the script file and make sure the prompts are still
  7363.               valid. If they aren't then you might consider relearning the
  7364.               script by deleting it and reconnecting to the remote system.
  7365.               If the prompt is correct than it's likely that you're
  7366.               needing a WAIT command preceding the RECEIVE. If the script
  7367.               is timing out immediately after a file transfer then try
  7368.               using a WAIT with no parameters, otherwise try increasing
  7369.               the time out by thirty seconds with WAIT 30. If you already
  7370.               have a WAIT command in your script at this point then try
  7371.               incrementing it by, say, thirty seconds until a suitable
  7372.               length of time is reached.
  7373.  
  7374.     Message : CANNOT WRITE TO PANTHER PHONE DIRECTORY!
  7375.     Number  : 3
  7376.     Meaning : Something is stopping the phone directory from updating.
  7377.     Remedy  : This could be due to a full disk or to a disk error. It
  7378.               could also be caused by you shelling to DOS during PANTHER
  7379.               and setting the Read Only attribute on the file!
  7380.  
  7381.     Message : NO CONNECT STRING RECEIVED!
  7382.     Number  : 4
  7383.     Meaning : PANTHER has managed to get a signal carrier but has
  7384.               received no connect string that it recognises from the
  7385.               modem.
  7386.     Remedy  : Check your modem string settings. It may be that you have
  7387.               set up a connect string which your modem will not generate.
  7388.  
  7389.  
  7390.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 112
  7391.  
  7392.  
  7393.  
  7394.  
  7395.  
  7396.  
  7397.  
  7398.  
  7399.     Message : DIRECTORY <file> IS EMPTY, CANNOT AUTODIAL!
  7400.     Number  : 5
  7401.     Meaning : You've tried to create an Auto Dialler control file using a
  7402.               blank dialling directory.
  7403.     Remedy  : In future, don't use blank dialling directories...
  7404.  
  7405.     Message : SCRIPT FILE TIMED OUT ON AUTO DIALLER!
  7406.     Number  : 6
  7407.     Meaning : The script file timed out during an Auto Dialler session.
  7408.     Remedy  : If a script file times out and therefore closed during the
  7409.               Auto Dialler then the carrier is unceremoniously dropped. Why
  7410.               did the script file time out on you? Examine the script file
  7411.               and make sure the prompts are still valid. If they aren't
  7412.               then you might consider relearning the script by deleting it
  7413.               and reconnecting to the remote system. If the prompt is
  7414.               correct than it's likely that you're needing a WAIT command
  7415.               preceding the RECEIVE. If the script is timing out
  7416.               immediately after a file transfer then try using a WAIT with
  7417.               no parameters, other wise try increasing the time out by
  7418.               thirty seconds with WAIT 30. If you already have a WAIT
  7419.               command in your script at this point then try incrementing it
  7420.               by, say, thirty seconds until a suitable length of time is
  7421.               reached.
  7422.  
  7423.     Message : CANNOT AUTO DIAL, NO SCRIPT FILE FOR <Remote System> !
  7424.     Number  : 7
  7425.     Meaning : You've tried to create an Auto Dialler control file for a
  7426.               remote system for which there is no associated script file
  7427.               in the copy of the dialling directory entry held in the Auto
  7428.               Dialler Control file.
  7429.     Remedy  : Either choose an entry which *does* have an associated
  7430.               script file, or back out of the Auto Dialler menus and check
  7431.               the dialling directory entry. Remember, the Auto Dialler
  7432.               control file editor does *not* check for the physical
  7433.               presence of the script file, only that there is an entry for
  7434.               one in the dialling directory. (If there is no script file
  7435.               found at dialling time then the Auto Dialler won't even dial
  7436.               the number but will continue onto the next number in the
  7437.               queue.)
  7438.  
  7439.     Message : AUTO DIAL HALTED - NO DATA RECEIVED FROM <Remote System> !
  7440.     Number  : 8
  7441.     Meaning : Auto Dialler has not received any data from the remote
  7442.               system within the past 'x' seconds where 'x' is the time
  7443.               after which the Auto Dialler will hang up if no data is
  7444.               received (the Auto Dialler Time Out set in the Configuration
  7445.               menu)
  7446.     Remedy  : It's probable that your script file is either set up for the
  7447.               wrong prompts or else the remote system is sending different
  7448.               prompts from those in the script (which is possible). It
  7449.               could also be that the remote system has 'hung'. Try running
  7450.               the script file in real time (ie, without using the Auto
  7451.               Dialler) and see what happens. If the script still fails
  7452.               then try relearning the script by deleting it and calling
  7453.               again manually.
  7454.  
  7455.  
  7456.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 113
  7457.  
  7458.  
  7459.  
  7460.  
  7461.  
  7462.  
  7463.  
  7464.  
  7465.  
  7466.     Message : CANNOT CREATE <File Name> !
  7467.     Number  : 9
  7468.     Meaning : PANTHER has had difficulty in creating one of its support
  7469.               files.
  7470.     Remedy  : This could be due to any one of a number of disk or physical
  7471.               Input/Output errors. This error is identical to that in
  7472.               error #19.
  7473.  
  7474.     Message : NO MODEM DETECTED ON COM PORT <Port Number> !
  7475.     Number  : 10
  7476.     Meaning : PANTHER has entered the dialling procedure or has started
  7477.               up terminal mode or has started auto dialling and PANTHER
  7478.               cannot find a working modem attached to the serial port set
  7479.               up in the Configuration menu.
  7480.     Remedy :  If the port number in the Configuration menu is wrong then
  7481.               change it. If the Port Number is correct then the problem
  7482.               may be one of a few things. Try restarting PANTHER with the
  7483.               /NOCHECKING parameter to disable checking for a modem in
  7484.               this manner. This can sometimes happen when all is otherwise
  7485.               well if PANTHER is running under Microsoft Windows.
  7486.  
  7487.     Message : COULD NOT UPLOAD <File Name>  - DOS ERROR <Code>
  7488.     Number  : 11
  7489.     Meaning : The external protocol you were using to execute the upload
  7490.               returned a non-zero DOS ERRORLEVEL.
  7491.     Remedy  : It may be that the file did not exist. It is also possible
  7492.               that the file transfer was flawless but that the protocol
  7493.               program returned a non-zero ERRORLEVEL anyway (maybe due to a
  7494.               number of time outs). Check the for existence of the file in
  7495.               the upload directory. Also, check through the protocol log
  7496.               file (if you have one set up - generated by the protocol
  7497.               program, not PANTHER!) for any errors.
  7498.  
  7499.     Message : COULD NOT DOWNLOAD <File Name>  - DOS ERROR <Code>
  7500.     Number  : 12
  7501.     Meaning : The external protocol you were using to execute the download
  7502.               returned a non-zero DOS ERRORLEVEL.
  7503.     Remedy  : It may be that the file did not exist. It is also possible
  7504.               that the file transfer was flawless but that the protocol
  7505.               program returned a non-zero ERRORLEVEL anyway (maybe due to a
  7506.               number of time outs). Check the for existence of the file in
  7507.               the download directory. Also, check through the protocol log
  7508.               file (if you have one set up - generated by the protocol
  7509.               program, not PANTHER!) for any errors.
  7510.  
  7511.     Message : SCRIPT FILE ERROR - COULD NOT DELETE <File Name>
  7512.     Number  : 13
  7513.     Meaning : You have attempted to delete an 'undeletable' file using the
  7514.               DELETE script file command.
  7515.     Remedy  : Either the file did not exist in the first place, it is set
  7516.               to Read Only or there has been a disk read/write error.
  7517.  
  7518.  
  7519.  
  7520.  
  7521.  
  7522.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 114
  7523.  
  7524.  
  7525.  
  7526.  
  7527.  
  7528.  
  7529.  
  7530.  
  7531.     Message : CANNOT CREATE - "PANTHER.MAC" MACRO FILE
  7532.     Number  : 14
  7533.     Meaning : PANTHER cannot recreate a 'lost' macro file.
  7534.     Remedy  : When PANTHER starts up it checks for the presence of all
  7535.               its support files. If it cannot find the PANTHER.MAC macro
  7536.               file then it tries to recreate a blank one. If this fails
  7537.               then this error is shown. You may have a full disk, or you
  7538.               might have experienced a disk I/O error.
  7539.  
  7540.     Message : TEXT FILE <File Name> DOES NOT EXIST!
  7541.     Number  : 15
  7542.     Meaning : A text file you are trying to upload by ALT-U doesn't exist.
  7543.     Remedy  : Try selecting the text file from the directory menu (called
  7544.               by pressing return on the blank input box) instead of typing
  7545.               the file name in. You've probably mis-spelled the name.
  7546.  
  7547.     Message : MINIMUM CONNECTION SPEED NOT REACHED!
  7548.     Number  : 16
  7549.     Meaning : The minimum speed compelled by the MINIMUM SPEED script file
  7550.               command was not reached on connection.
  7551.     Remedy  : Try calling again. The speed may have been downwardly
  7552.               renegotiated due to line noise. Alternatively, you might be
  7553.               specifying a minimum connection rate higher than that which
  7554.               the remote service or your modem can operate at!
  7555.  
  7556.     Message : CANNOT INITIALISE PORT COM <PORT NUMBER>
  7557.     Number  : 17
  7558.     Meaning : An error occurred whilst initialising the selected port.
  7559.     Remedy  : If your running PANTHER with the /NOCHECKING parameter then
  7560.               try running it without it and see if PANTHER reports the
  7561.               presence of a modem on the selected port. If it doesn't then
  7562.               ensure you're set up for the right serial port through the
  7563.               configuration menu. If you are then try changing the serial
  7564.               cable with which you connect to your modem.
  7565.  
  7566.     Message : CANNOT FIND READ FROM <File Name>
  7567.     Number  : 18
  7568.     Meaning : A file error happened during a disk read.
  7569.     Remedy  : The file may be corrupted (wrong length) or may make 'no
  7570.               sense' to PANTHER. Alternatively, a disk hardware failure
  7571.               may have occurred. Try restoring the offending file from a
  7572.               back up. (Yes, those again!)
  7573.  
  7574.     Message : CANNOT CREATE <File Name>
  7575.     Number  : 19
  7576.     Meaning : PANTHER has had difficulty in creating one of its support
  7577.               files.
  7578.     Remedy  : This could be due to any one of a number of disk or physical
  7579.               Input/Output errors. The disk may be full, there may be a
  7580.               disk read error, the file may have the Read Only attribute
  7581.               set. Try freeing up some disk space or setting all file
  7582.               attributes to Archive only. If the error persists then
  7583.               suspect the disk is faulty.
  7584.  
  7585.  
  7586.  
  7587.  
  7588.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 115
  7589.  
  7590.  
  7591.  
  7592.  
  7593.  
  7594.  
  7595.  
  7596.  
  7597.     Message : CANNOT APPEND DATA TO <File Name>
  7598.     Number  : 20
  7599.     Meaning : PANTHER has had difficulty in appending (adding) data to
  7600.               one of its support files.
  7601.     Remedy  : This could be due to any one of a number of disk or physical
  7602.               Input/Output errors. The disk may be full, there may be a
  7603.               disk read error, the file may have the Read Only attribute
  7604.               set. Try freeing up some disk space or setting all file
  7605.               attributes to Archive only. If the error persists then
  7606.               suspect the disk is faulty.
  7607.  
  7608.     Message : CANNOT CLOSE <File Name> UPDATES MAY BE LOST!
  7609.     Number  : 21
  7610.     Meaning : A file that PANTHER has previously opened cannot be closed
  7611.               and updated. Any changes made to the file (or even the file
  7612.               itself) may be permanently lost.
  7613.     Remedy  : This could be due to any one of a number of disk or physical
  7614.               Input/Output errors. The disk may be full, there may be a
  7615.               disk read error, the file may have the Read Only attribute
  7616.               set. In future, try freeing up some disk space or setting
  7617.               all file attributes to Archive only. If this error occurs
  7618.               then it is unlikely to be recoverable.
  7619.  
  7620.     Message : CURRENT SCRIPT FILE LOST ON PATH! ABORTING SCRIPT!
  7621.     Number  : 22
  7622.     Meaning : A script file being currently used has been 'lost'!
  7623.     Remedy  : One of two scenarios; either you're doing comms work in a
  7624.               multitasker and have deleted the script file whilst it was
  7625.               in use, or else you've got a problem with the logical
  7626.               structure of your disk. If the former then you probably
  7627.               deserve all you get...(!)...if the latter then disk
  7628.               recovery/diagnostic tools may be in order...
  7629.  
  7630.     Message : CANNOT READ FROM MACRO FILE! ASSUMING ALL MACROS ARE BLANK!
  7631.     Number  : 23
  7632.     Meaning : PANTHER has failed to read from the PANTHER.MAC macro
  7633.               definition file and is assuming that no macros are
  7634.               specified.
  7635.     Remedy  : The macro file may be corrupted (ie, the wrong length).
  7636.               When PANTHER starts up it checks for the presence of all
  7637.               its support files. If it cannot find the PANTHER.MAC macro
  7638.               file then it tries to recreate a blank one. If you get this
  7639.               error after the macro file has been created (without error)
  7640.               then you may have a disk problem.
  7641.  
  7642.     Message : CANNOT DELETE <File Name>
  7643.     Number  : 24
  7644.     Meaning : PANTHER cannot delete the specified file.
  7645.     Remedy  : The file attributes may be set to read only, or the file may
  7646.               not even exist!
  7647.  
  7648.  
  7649.  
  7650.  
  7651.  
  7652.  
  7653.  
  7654.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 116
  7655.  
  7656.  
  7657.  
  7658.  
  7659.  
  7660.  
  7661.  
  7662.  
  7663.     Message : CANNOT READ FROM <File Name>
  7664.     Number  : 25
  7665.     Meaning : PANTHER cannot read from the specified file.
  7666.     Remedy  : The file specified may not exist or you may be experiencing
  7667.               a disk problem. Alternatively, the file attributes may be
  7668.               set to System or Hidden.
  7669.  
  7670.     Message : CANNOT WRITE TO <File Name>
  7671.     Number  : 26
  7672.     Meaning : PANTHER cannot write to the specified file.
  7673.     Remedy  : This could be due to any one of a number of disk or physical
  7674.               Input/Output errors. The disk may be full, there may be a
  7675.               disk read error, the file may have the Read Only attribute
  7676.               set. Try freeing up some disk space or setting all file
  7677.               attributes to Archive only. If the error persists then
  7678.               suspect the disk is faulty.
  7679.  
  7680.     Message : CANNOT AUTO DIAL AS CONTROL FILE <File Name> DOES NOT EXIST!
  7681.     Number  : 27
  7682.     Meaning : You've tried to start Auto Dialling on a non-existent
  7683.               control file!
  7684.     Remedy  : The only way you could *possibly* manage this spectacular
  7685.               trick is by starting up the Auto Dialler menu (which detects
  7686.               and lists all the control files available) and then somehow
  7687.               deleting the control file in the interim period (maybe by
  7688.               doing it through a multitasking system like Windows or
  7689.               DESQview). This is identical to the fatal error listed above
  7690.               but will only be displayed if your are Auto Dialling from
  7691.               within PANTHER. This error will NOT abort the program.
  7692.  
  7693.     Message : CANNOT FIND PANTHER.EXE ON PROGRAM PATH! - PLEASE RE-ENTER!
  7694.     Number  : 28
  7695.     Meaning : You've entered a path in the configuration PATHS menu which
  7696.               does not contain PANTHER.EXE.
  7697.     Remedy  : Either enter the correct path or, if you are unsure, quit
  7698.               the menu with ESC, don't save changes and check the
  7699.               directory contents from DOS.
  7700.  
  7701.     Message : FILE OR PATHNAME DOES NOT EXIST! - SELECT FROM MENU!
  7702.     Number  : 29
  7703.     Meaning : You've attempted to execute a file transfer by using an
  7704.               invalid (or non-existent) file or path to that file.
  7705.     Remedy  : Check the paths set in your configuration set up. Ensure
  7706.               that you haven't deleted the directories that the upload or
  7707.               download paths refer to. Alternatively, it may be that the
  7708.               file you are attempting to upload does not exist.
  7709.  
  7710.  
  7711.  
  7712.  
  7713.  
  7714.  
  7715.  
  7716.  
  7717.  
  7718.  
  7719.  
  7720.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 117
  7721.  
  7722.  
  7723.  
  7724.  
  7725.  
  7726.  
  7727.  
  7728.  
  7729.     Message : MAXIMUM AUTO DIALLER CONNECTION TIME EXCEEDED!
  7730.     Number  : 30
  7731.     Meaning : Your Auto Dialler session has been terminated by PANTHER
  7732.               detecting that you have reached the maximum time period you
  7733.               have allocated for that call.
  7734.     Remedy  : Check to see you allocated enough time for the call.
  7735.               Although unlikely, it may also be that you have a WAIT
  7736.               command (with no passed arguments) awaiting a string from the
  7737.               remote system and Auto Dialler and Script File time outs (set
  7738.               in the Program Settings section) set to longer than the
  7739.               allowed duration of the call.
  7740.  
  7741.     Message : <File Name> NOT FOUND!
  7742.     Number  : 31
  7743.     Meaning : PANTHER cannot find the external protocol program file.
  7744.     Remedy  : You have set up the protocols through PANTHER and have then
  7745.               deleted the protocol program. Either restore the program to
  7746.               the protocol directory or select a new protocol to use.
  7747.  
  7748.     Message : NO REPLY RECEIVED FROM MODEM!
  7749.     Number  : 32
  7750.     Meaning : PANTHER has sent either the RESET MODEM or INITIALISE MODEM
  7751.               strings to the port from the dialling directory and has
  7752.               failed to receive a response of any kind from your modem.
  7753.     Remedy  : If you have started PANTHER with the /NOCHECKING switch
  7754.               then check your modem is switched on and plugged in. If this
  7755.               is not the case then ensure that your serial cable is
  7756.               intact. If this error persists and you are certain that
  7757.               your modem is working then contact the authors.
  7758.  
  7759.     Message : MODEM ERROR STRING RECEIVED ON SENDING <name> STRING!
  7760.     Number  : 33
  7761.     Meaning : PANTHER has sent either the RESET MODEM or INITIALISE MODEM
  7762.               strings to the port from the dialling directory and has
  7763.               received the specified 'MODEM ERROR' string back from your
  7764.               modem.
  7765.     Remedy  : Check that the strings you're specifying are valid strings
  7766.               for the modem being used.
  7767.  
  7768.     Message : LABEL <label name> NOT FOUND IN SCRIPT! ABORTING!
  7769.     Number  : 34
  7770.     Meaning : You've issued a GOTO LABELNAME script command where a label
  7771.               by that name doesn't exist.
  7772.     Remedy  : Edit the GOT statement or add an appropriate label to the
  7773.               script. Remember that labels must be marked as being such by
  7774.               prefixing the label name with the word LABEL.
  7775.  
  7776.     Message : LABEL <label name> NOT FOUND IN SCRIPT! ABORTING!
  7777.     Number  : 34
  7778.     Meaning : You've issued a GOTO LABELNAME script command where a label
  7779.               by that name doesn't exist.
  7780.     Remedy  : Edit the GOT statement or add an appropriate label to the
  7781.               script. Remember that labels must be marked as being such by
  7782.               prefixing the label name with the word LABEL.
  7783.  
  7784.  
  7785.  
  7786.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 118
  7787.  
  7788.  
  7789.  
  7790.  
  7791.  
  7792.  
  7793.  
  7794.  
  7795.     Message : PRINTER ERROR! OUT OF PAPER!
  7796.     Number  : 35
  7797.     Meaning : You've tried to print the dialling directory or start a
  7798.               printer capture session without there being any paper in
  7799.               your printer.
  7800.     Remedy  : Load the printer with paper and try again.
  7801.  
  7802.     Message : PRINTER ERROR! PRINTER OFF LINE!
  7803.     Number  : 36
  7804.     Meaning : You've tried to print the dialling directory or start a
  7805.               printer capture session either without the printer being on
  7806.               line (ie ready) or without there being a printer attached to
  7807.               the computer at all.
  7808.     Remedy  : Either turn the printer on line or go out and buy one! If
  7809.               all is apparently well with your printer and yet you still
  7810.               get the error you *may* have a problem with your parallel
  7811.               cable. Either try using another cable altogether, preferably
  7812.               one as short as you can manage.
  7813.  
  7814.     Message : PRINTER ERROR! PRINTER BUSY!
  7815.     Number  : 37
  7816.     Meaning : You've tried to print the dialling directory or start a
  7817.               printer capture session either with the printer already busy
  7818.               doing another task.
  7819.     Remedy  : Wait until the printer is idle before retrying the
  7820.               operation.
  7821.  
  7822.     Message : UNKNOWN PRINTER ERROR!
  7823.     Number  : 38
  7824.     Meaning : You've tried to print the dialling directory or start a
  7825.               printer capture session and have experienced a hardware
  7826.               failure.
  7827.     Remedy  : Refer to your printer manuals for doing diagnostic
  7828.               self-tests. It's possible that your printer is faulty.
  7829.  
  7830.     Message : CANNOT RENAME <file name> !
  7831.     Number  : 39
  7832.     Meaning : You've issued a REN[AME] command in a PANTHER script file
  7833.               but have specified an invalid target name.
  7834.     Remedy  : Make sure that the target and source names are different;
  7835.               make sure that the source file exists; make sure that the
  7836.               target file *doesn't* exist; make sure you've given a target
  7837.               file name in the first place; make sure that both your
  7838.               target and source file names are valid DOS file names.
  7839.  
  7840.     Message : CANNOT COPY <file name> !
  7841.     Number  : 40
  7842.     Meaning : You've issued a COPY command in a PANTHER script file
  7843.               but have encountered some problem.
  7844.     Remedy  : Make sure that the source file exists; make sure that the
  7845.               target file (if it exists, that is) hasn't got a read-only
  7846.               attribute set on it; if you are specifying a target directory
  7847.               as well as a file name in your target, make sure the
  7848.               directory exists; make sure you have specified a valid DOS
  7849.               target file name.
  7850.  
  7851.  
  7852.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 119
  7853.  
  7854.  
  7855.  
  7856.  
  7857.  
  7858.  
  7859.  
  7860.  
  7861.     Message : CANNOT MAKE DIRECTORY <directory name> !
  7862.     Number  : 41
  7863.     Meaning : You've issued a MD or MKDIR command in a PANTHER script
  7864.               file but have encountered some problem.
  7865.     Remedy  : Make sure that the directory name doesn't already exist;
  7866.               make sure that the specified directory name is a valid DOS
  7867.               file name.
  7868.  
  7869.     Message : CANNOT REMOVE DIRECTORY <directory name> !
  7870.     Number  : 42
  7871.     Meaning : You've issued an RD or RMDIR command in a PANTHER script
  7872.               file but have encountered some problem.
  7873.     Remedy  : Make sure that the directory name actually exists; make sure
  7874.               that the specified directory is empty of other files and/or
  7875.               directories; make sure that the specified directory name is a
  7876.               valid DOS file name.
  7877.  
  7878.     Message : CANNOT CHAIN TO SCRIPT FILE <script name> !
  7879.     Number  : 43
  7880.     Meaning : You've issued a CHAIN command in a script file but the
  7881.               target script file doesn't exist.
  7882.     Remedy  : Ensure that the target script file exists within the script
  7883.               file path as specified in your configuration. Another common
  7884.               source of error is in using some file locking systems with
  7885.               multitasking software - make sure you don't have the target
  7886.               script file 'open' in a text editor while trying to chain to
  7887.               it - the file locking system (like the DOS SHARE program)
  7888.               will prevent the same file being opened in two different
  7889.               sessions and will bar PANTHER from reading the file, thereby
  7890.               preventing the CHAIN from working.
  7891.  
  7892.     Message : SPECIFIED FILE LISTING DOES NOT EXIST!
  7893.     Number  : 44
  7894.     Meaning : You've started up PANTHER with the FILE=<FileListName>
  7895.               command line switch to read in a file listing at start up
  7896.               but the specified file doesn't exist.
  7897.     Remedy  : Ensure that the specified file listing actually exists.
  7898.               Another common source of error is in using some file locking
  7899.               systems with multitasking software - make sure you don't have
  7900.               the file listing file 'open' in a text editor while trying to
  7901.               start up PANTHER in this manner - the file locking system
  7902.               (like the DOS SHARE program) will prevent the same file being
  7903.               opened in two different sessions and will bar PANTHER from
  7904.               reading the file, thereby preventing the file list from being
  7905.               read in.
  7906.  
  7907.     Message : <File type> RAW LOG FILE DOES NOT EXIST!
  7908.     Number  : 45
  7909.     Meaning : You've tried to view a raw log file only to find that it
  7910.               doesn't actually exist.
  7911.     Remedy  : Try another one?
  7912.  
  7913.  
  7914.  
  7915.  
  7916.  
  7917.  
  7918.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 120
  7919.  
  7920.  
  7921.  
  7922.  
  7923.  
  7924.  
  7925.  
  7926.  
  7927.     Message : DOWNLOAD DIRECTORY MISSING! USING PROGRAM DIRECTORY!
  7928.     Number  : 46
  7929.     Meaning : PANTHER has started a file transfer download only to find
  7930.               that the download directory doesn't actually exist!
  7931.     Remedy  : To effect a download, PANTHER checks to see if the download
  7932.               directory exists or not. If it doesn't then it will default
  7933.               to using the main program directory. If you get this error
  7934.               then simply recreate (or redefine) the download directory.
  7935.  
  7936.     Message : END OF SCRIPT REACHED WITHOUT LABEL FOUND! ABORTING SCRIPT!
  7937.     Number  : 47
  7938.     Meaning : PANTHER was acting on a GOTO script command but hasn't found
  7939.               the label referred to. The script will be aborted.
  7940.     Remedy  : Rewrite the script file accordingly to include the label in
  7941.               the appropriate place.
  7942.  
  7943.     Message : END OF SCRIPT REACHED AND NO 'DOS STOP' FOUND! ABORTING
  7944.               SCRIPT!
  7945.     Number  : 48
  7946.     Meaning : PANTHER was acting on a DOS START script command but did not
  7947.               find the appropriate DOS STOP pair to end your series of DOS
  7948.               commands. This script will be aborted.
  7949.     Remedy  : Rewrite the script file accordingly to include the DOS
  7950.               STOP command in the appropriate place, immediately after
  7951.               your series of DOS commands to be executed.
  7952.  
  7953.     Message : END OF SCRIPT REACHED WITHOUT 'WEND' FOUND!  ABORTING
  7954.               SCRIPT!
  7955.     Number  : 49
  7956.     Meaning : PANTHER was acting on a WHILE script command but did not
  7957.               find the appropriate WEND command to terminate the
  7958.               conditional block of statements to be acted on under the
  7959.               'while' condition.
  7960.     Remedy  : Rewrite the script file accordingly to include the WEND
  7961.               command in the appropriate place.
  7962.  
  7963.     Message : END OF SCRIPT REACHED WITHOUT 'THEN' FOUND! ABORTING SCRIPT!
  7964.     Number  : 50
  7965.     Meaning : PANTHER was acting on an IF script command but did not find
  7966.               a THEN command to match it.
  7967.     Remedy  : Rewrite the script file accordingly to include the THEN in
  7968.               the correct place. Bear in mind that THEN statements MUST
  7969.               occupy their own line in the script file and that
  7970.               conditional statements cannot be nested within each other.
  7971.  
  7972.  
  7973.  
  7974.  
  7975.  
  7976.  
  7977.  
  7978.  
  7979.  
  7980.  
  7981.  
  7982.  
  7983.  
  7984.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 121
  7985.  
  7986.  
  7987.  
  7988.  
  7989.  
  7990.  
  7991.  
  7992.  
  7993.     Message : END OF SCRIPT AND NO 'ELSE/ENDIFF' FOUND! ABORTING SCRIPT!
  7994.     Number  : 51
  7995.     Meaning : PANTHER was acting on a THEN script command but did not find
  7996.               either an ELSE condition to match or an ENDIFF statement to
  7997.               terminate the conditional block of statements to be acted on
  7998.               under the 'if' condition.
  7999.     Remedy  : Rewrite the script file accordingly to include the ELSE
  8000.               condition or ENDIFF statement in the correct place.  Bear in
  8001.               mind that ELSE and ENDIFF statements MUST occupy their own
  8002.               line in the script file and that conditional statements
  8003.               cannot be nested within each other.
  8004.  
  8005.     Message : END OF SCRIPT REACHED WITHOUT 'ENDIFF' FOUND!  ABORTING
  8006.               SCRIPT!
  8007.     Number  : 52
  8008.     Meaning : PANTHER was acting on an 'ELSE' script command but did not
  8009.               find the appropriate ENDIFF statement to terminate the
  8010.               conditional block of statements to be acted on under the
  8011.               'else' condition.
  8012.     Remedy  : Rewrite the script file accordingly to include the ENDIFF
  8013.               statement in the correct place.  Bear in mind that ELSE and
  8014.               ENDIFF statements MUST occupy their own line in the script
  8015.               file and that conditional statements cannot be nested within
  8016.               each other.
  8017.  
  8018.  
  8019.  
  8020.  
  8021.  
  8022.  
  8023.  
  8024.  
  8025.  
  8026.  
  8027.  
  8028.  
  8029.  
  8030.  
  8031.  
  8032.  
  8033.  
  8034.  
  8035.  
  8036.  
  8037.  
  8038.  
  8039.  
  8040.  
  8041.  
  8042.  
  8043.  
  8044.  
  8045.  
  8046.  
  8047.  
  8048.  
  8049.  
  8050.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 122
  8051.  
  8052.  
  8053.  
  8054.  
  8055.  
  8056.  
  8057.  
  8058.  
  8059.     GLOSSARY OF TERMS
  8060.     -----------------
  8061.  
  8062.     Anything to do with computer communications is a minefield of jargon
  8063.     and esoteric terminology. What follows below is an attempt to
  8064.     consolidate some of the terms used in the field of comms. It's not
  8065.     meant to be completely exhaustive, nor it is supposed to be
  8066.     particularly detailed, but it's a start!
  8067.  
  8068.     ARQ - Automatic Repeat Request. This is a generalised term for error
  8069.          correction methods which have the ability to re-request corrupted
  8070.          data blocks.
  8071.  
  8072.     ASYNCHRONOUS TRANSMISSION - Probably the most common form of data
  8073.          transference where both the transmitting and receiving modems do
  8074.          not run in synchronisation with each other. Data is sent with
  8075.          'start' and 'stop' bits allowing each modem to know when to start
  8076.          and when to stop.
  8077.  
  8078.     AUTO ANSWER MODE - When a modem is in auto answer mode it can answer
  8079.          incoming calls from other modems.
  8080.  
  8081.     BAUD - The baud rate signifies the modems speed and is roughly (at
  8082.          lower speeds anyway) analogous to the bits transferred per
  8083.          second. It is more accurately described as being the number of
  8084.          discrete signal events occurring on the channel. 1200 baud means
  8085.          that roughly 1200 bits are being transferred (in either
  8086.          direction) at any one time. As each byte is composed of two bits
  8087.          and there are usually two bits added for the asynchronous
  8088.          transfer, the transferred bits per second is roughly the baud
  8089.          rate divided by ten. Incidentally, the word 'baud' is a
  8090.          contraction of the name of the Frenchman (Baudot) who invented a
  8091.          very old communications code for teletype machines.
  8092.  
  8093.     CARRIER SIGNAL - A carrier the a continuous frequency which can be
  8094.          either modulated or embedded with the data being transmitted by
  8095.          another signal. Carriers are generated and maintained by the
  8096.          modem.
  8097.  
  8098.     CRC - Cyclic Redundancy Checking. An error correction method which
  8099.          consists of an algorithm enacted upon every block of data
  8100.          received or sent by a modem. The sending modem embeds it CRC
  8101.          calculations within each block and the receiving modem compares
  8102.          this figure with the one it independently reached. If the figures
  8103.          agree then the receiving modem sends an acknowledgement character
  8104.          (ACK) or of negative an acknowledgement character (NAK) if it
  8105.          disagrees.
  8106.  
  8107.     CTS - Clear To Send, an RS232 signal.
  8108.  
  8109.  
  8110.  
  8111.  
  8112.  
  8113.  
  8114.  
  8115.  
  8116.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 123
  8117.  
  8118.  
  8119.  
  8120.  
  8121.  
  8122.  
  8123.  
  8124.  
  8125.     DATA COMPRESSION - As telephone communications are relatively
  8126.          expensive, particularly over longer distances, it helps to stores
  8127.          the information in your files in a compressed format which allows
  8128.          the data to be transmitted faster and hence cheaper. Compression
  8129.          is usually taken place prior to transmission by specific
  8130.          software, but it can also be done whilst the transmission is in
  8131.          progress using MNP 5.
  8132.  
  8133.     DCD - Data Carrier Detect, an RS232 signal.
  8134.  
  8135.     DOWNLOADING - Receiving data (usually in the form of a computer file)
  8136.          from a remote modem.
  8137.  
  8138.     DSR - Data set ready, an RS232 signal.
  8139.  
  8140.     DUPLEX - The direction of the data transfer. Half duplex means that
  8141.          only one modem can 'talk' at the one time, something like a two
  8142.          way radio. At full duplex, both modems can 'talk' at the same
  8143.          time, as in a telephone conversation.
  8144.  
  8145.     FALLBACK - When two modems talk for the first time they try to
  8146.          negotiate for the highest line speed possible. If they cannot do
  8147.          this then they fall back to the highest speed they can manage at.
  8148.          Fallback can also occur if the line conditions deteriorate and
  8149.          higher speed communications become impossible. Some modems have
  8150.          the capability of renegotiating the line speed once conditions
  8151.          become more favourable.
  8152.  
  8153.     HANDSHAKING - A method of compensating for the receiver having to
  8154.          break transfer briefly whilst it processes the data received.
  8155.          This can either be enabled by software (XON/XOFF) or by hardware
  8156.          (RTS/CTS).
  8157.  
  8158.     LAPM - Link Access Procedure for Modems, a sophisticated form of error
  8159.          correction for modems and built into V42.
  8160.  
  8161.     LEARN FACILITY - A capability of your comms software to monitor what
  8162.          you are typing at your keyboard and remember it, writing a script
  8163.          file for you in the process.
  8164.  
  8165.     LINE NOISE - Disturbances in the quality of the telephone line caused
  8166.          by adverse conditions, resulting in corruption of the data being
  8167.          transferred. If error checking modems or software is being used
  8168.          then the corrupted data will be rejected by the receiver and the
  8169.          transmitter will be forced to resend the data block.
  8170.  
  8171.     MODEM - A contraction of modulator/demodulator. Not all lines are
  8172.          constructed to convey digital signals, so the signals are
  8173.          converted into audio tones, a process known as modulation, which
  8174.          are passed over the telephone lines. The demodulation -
  8175.          converting sound to data - takes place at the receiving end.
  8176.  
  8177.  
  8178.  
  8179.  
  8180.  
  8181.  
  8182.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 124
  8183.  
  8184.  
  8185.  
  8186.  
  8187.  
  8188.  
  8189.  
  8190.  
  8191.     MNP - Microcom Networking Protocol, a standard method of error
  8192.          correction and a method of eliminating line noise. This is mostly
  8193.          implemented in modems although some forms of MNP occur in
  8194.          software. For MNP to work, both modems must be using it.
  8195.  
  8196.     PARITY - If you are only sending text files across the line then the
  8197.          eighth bit of each byte isn't actually used by the data and can
  8198.          be used for a simple form of error checking called parity
  8199.          checking. Both the receiving and transmitting systems must be
  8200.          using the same parity checking system. As transferring binary
  8201.          files involves the use of all eight bits of each byte, parity
  8202.          checking is set to none.
  8203.  
  8204.     PROTOCOL - A protocol is a series of rules which define the
  8205.          communications between two or more devices. The external protocol
  8206.          transfer programs you run, send and receive data in preordained
  8207.          ways according to the rules which they adhere to, hence the
  8208.          importance of ensuring that both sender and receiver are
  8209.          observing the protocol. Standard file transfer protocol standards
  8210.          are the Xmodem, Ymodem and Zmodem.
  8211.  
  8212.     RD - Receive Data, An RS-232 signal, often found represented in a
  8213.          light on the front of your modem. When the light is illuminated
  8214.          your are receiving data.
  8215.  
  8216.     REN - Ringer Equivalence Number, the electronic 'weight' that each
  8217.          telecommunications items carries and places on the line. You can
  8218.          connect items up to a total of 4REN on household British Telecom
  8219.          lines.
  8220.  
  8221.     RS232 - The technical designation for the serial port structure of the
  8222.          IBM Personal Computer. It is also known as the serial port or the
  8223.          asynchronous communications port.
  8224.  
  8225.     RTS - Request To Send, an RS232 signal.
  8226.  
  8227.     SCRIPT - A script language is a form of (usually) simplistic language
  8228.          that allows you to automate most of your on line tasks without
  8229.          any intervention.
  8230.  
  8231.     SD - Send data, An RS-232 signal, often found represented in a light
  8232.          on the front of your modem. When the light is illuminated your
  8233.          are sending data.
  8234.  
  8235.     SYNCHRONOUS TRANSMISSION - This is a method of transfer more commonly
  8236.          used with mainframe computers where both receiving and
  8237.          transmitting modems run in synchronisation controlled by a clock
  8238.          timer.
  8239.  
  8240.     UPLOADING - Sending data (usually in the form of a computer file) to a
  8241.          remote modem.
  8242.  
  8243.     V21 - Full duplex modem transmission at 300 baud
  8244.  
  8245.  
  8246.  
  8247.  
  8248.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 125
  8249.  
  8250.  
  8251.  
  8252.  
  8253.  
  8254.  
  8255.  
  8256.  
  8257.     V22 - Half duplex modem transmission at 600 and 1200 baud plus a spare
  8258.          reverse channel at 75 baud.
  8259.  
  8260.     V22bis - Full duplex transmission at 1200 baud and 2400 baud with
  8261.          fallback capabilities to V22.
  8262.  
  8263.     V23 - Full duplex transmission at 1200 baud and receive at 75 baud.
  8264.  
  8265.     V32 - Full duplex transmission at 4800 baud and 9600 baud. Modems
  8266.          following this standard can fall back to 4800 baud during adverse
  8267.          conditions and renegotiate to 9600 baud when conditions improve.
  8268.  
  8269.     V32bis - Full duplex transmission at 7200 baud, 1200 baud and 14400
  8270.          baud.
  8271.  
  8272.     V42 - An error correcting protocol incorporating MNP levels 1, 2, 3
  8273.          and 4.
  8274.  
  8275.     V42bis - An error correcting protocol incorporating MNP levels 2, 3
  8276.          and 4 and LAPM.
  8277.  
  8278.  
  8279.  
  8280.  
  8281.  
  8282.  
  8283.  
  8284.  
  8285.  
  8286.  
  8287.  
  8288.  
  8289.  
  8290.  
  8291.  
  8292.  
  8293.  
  8294.  
  8295.  
  8296.  
  8297.  
  8298.  
  8299.  
  8300.  
  8301.  
  8302.  
  8303.  
  8304.  
  8305.  
  8306.  
  8307.  
  8308.  
  8309.  
  8310.  
  8311.  
  8312.  
  8313.  
  8314.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 126
  8315.  
  8316.  
  8317.  
  8318.  
  8319.  
  8320.  
  8321.  
  8322.  
  8323.     ACKNOWLEDGEMENTS
  8324.     ----------------
  8325.  
  8326.     I would like to thank the following people for their assistance in
  8327.     getting PANTHER version 2.00 off the ground;
  8328.  
  8329.     Derek Carroll for his co-authorship of COSWORTH, PANTHER's precursor,
  8330.     and for his assistance in designing some sections of PANTHER.
  8331.  
  8332.     Alastair McIntyre of Almac BBS.
  8333.  
  8334.     Gregory Smith for assistance and information on Avatar terminal
  8335.     emulation.
  8336.  
  8337.     Alan Barclay for assistance and information on VT terminal emulations.
  8338.  
  8339.     Roger Gregory, Sysop of FORTH VIEW bulletin board whose chance remark
  8340.     started the whole thing off.
  8341.  
  8342.     Phil, Eddie, Janet, Andrew, Martin, Frank, Ian, Sandy, Dave, Jeremy,
  8343.     Clive, Captain Flacks, Andy, Steven, Shakib, Douglas, Des, Peter,
  8344.     Corrie, Simon, Davie and all others who contributed their time in
  8345.     testing this software out.
  8346.  
  8347.  
  8348.  
  8349.     TRADEMARKS
  8350.     ----------
  8351.  
  8352.     The following products and trademarks are mentioned in this
  8353.     documentation;
  8354.  
  8355.       OS/2 version 2.0 is copyright International Business Machines
  8356.       Corporation 1992.
  8357.  
  8358.       Microsoft MS-DOS Version 5.00 is copyright Microsoft Corp 1981-1991.
  8359.  
  8360.       Microsoft Windows is copyright Microsoft Corp 1991.
  8361.  
  8362.       DESQview is a trademark of Quarterdeck Office Systems.
  8363.  
  8364.       4DOS is a registered trademark of and is copyright 1988, 1989,
  8365.       1990, 1991 by JP Software Inc.
  8366.  
  8367.       Turbo Pascal, Turbo Debugger, Turbo Assembler and Turbo Profiler are
  8368.       all copyright and registered trademarks of Borland International
  8369.       Inc.
  8370.  
  8371.       TechnoJock's Turbo Toolkit (tm) is copyright 1989 TechnoJock
  8372.       Software, Inc.
  8373.  
  8374.       DSZ is copyright by Omen Technology INC
  8375.  
  8376.       TheDraw is copyright (c) 1986,1987,1988,1989 by TheSoft Programming
  8377.       Services and Ian E. Davis
  8378.  
  8379.  
  8380.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 127
  8381.  
  8382.  
  8383.  
  8384.  
  8385.  
  8386.  
  8387.  
  8388.  
  8389.       QEdit Advanced Text Editor is copyright 1985-1991 by SemWare.
  8390.       SemWare and QEdit are reg. trademarks of Applied Systems
  8391.       Technologies.
  8392.  
  8393.       D'Bridge is copyright 1988/1989 by Chris Irwin.
  8394.  
  8395.       PC-Type is copyright 1986 by ButtonWare.
  8396.  
  8397.  
  8398.  
  8399.  
  8400.  
  8401.  
  8402.  
  8403.  
  8404.  
  8405.  
  8406.  
  8407.  
  8408.  
  8409.  
  8410.  
  8411.  
  8412.  
  8413.  
  8414.  
  8415.  
  8416.  
  8417.  
  8418.  
  8419.  
  8420.  
  8421.  
  8422.  
  8423.  
  8424.  
  8425.  
  8426.  
  8427.  
  8428.  
  8429.  
  8430.  
  8431.  
  8432.  
  8433.  
  8434.  
  8435.  
  8436.  
  8437.  
  8438.  
  8439.  
  8440.  
  8441.  
  8442.  
  8443.  
  8444.  
  8445.  
  8446.     PANTHER COMMUNICATIONS SOFTWARE version 2.00              page 128
  8447.  
  8448.  
  8449.  
  8450.  
  8451.  
  8452.  
  8453.  
  8454.  
  8455.      # (hash) 19, 74, 85                  connecting 47
  8456.      ^ (caret) 19, 74, 85                 COPY script command 70
  8457.      ~ (tilde) 85                         Cosworth 3, 8
  8458.      %PANTHER environment variable 13     data bits 43
  8459.      *BAUD 25                             DAYOFTHEWEEK script function 72
  8460.      *COMPORT 25                          DELETE script command 67
  8461.      *DOWNLOADPATH 74                     DIAG command line switch 15
  8462.      *FIRST 74, 85                        diagnostics file 15
  8463.      *FNAME 25                            dialling 45
  8464.      *LAST 74, 85                         Dialling Directory 37
  8465.      *LINESPEED 25                           commands 38
  8466.      *NAME 32, 73, 85                        default entry 30
  8467.      *PASSWORD 32, 42, 74, 85                diaply 37
  8468.      *PATH 25                                editing by macro 87
  8469.      *PROGRAMPATH 74                         editing entries 41
  8470.      *SCREENLINE 74, 77                      entry fields 41
  8471.      *UPLOADPATH 74                          keystrokes 40
  8472.      16550AFN (UART) 99                      timer 109
  8473.      4DOS 6, 13, 89, 109                  dialling prefix 1..5 21, 43, 86
  8474.      ALMAC BBS 7, 47                      DIR command line switch 14
  8475.      ANSI 44, 50, 61, 100                 directories 26, 116
  8476.      ASCII transfers 51                   DOS script command 69
  8477.      auto answer mode 100                 DOS Shell 49, 100, 108
  8478.      AUTO command line switch 14, 95,     DOWNLOAD script command 66
  8479.                               98          downloading 52, 54
  8480.      Auto Dialler 90                      EMS (Expanded memory) 6
  8481.         abandoning session 50, 96         ERASE script command 67
  8482.         automatic halting 113             error file 103
  8483.         description of 90                 errorlevels 16
  8484.         problems 117                      errors 103, 110, 111
  8485.         reporting 96                      EXIST script function 72
  8486.         safeguards 90                     exit codes 16
  8487.         setting up 91                     fatal errors 111
  8488.         smart scripts 96                  FILE command line switch 15
  8489.         starting session 14, 95, 98       File List 58
  8490.      auto Zmodem downloads 28                command line read 59
  8491.      AUTOBUF.BUF 63                          deleting 58
  8492.      Avatar 44, 50, 61, 100                  editing 51, 58, 100
  8493.      backspace 44, 50, 100                   sending 52, 59, 60
  8494.      batch file 13                        FILELISTING script function 72
  8495.      baud 42, 123                         GOTO script command 70
  8496.      BEEP script command 69               handshaking 43, 124
  8497.      binary save file 49, 104             hang up string 21, 86
  8498.      break signal 48                      hanging up 49
  8499.      busy strings 21, 46                  HANGUP script command 68
  8500.      capture file 49, 103, 107            hardware requirements 6
  8501.      carrier signal 35, 36, 107, 109,     HELP command line switch 14
  8502.                     123                   IBM OS/2 5, 6, 109, 105
  8503.      CHAIN script command 71              IEMSI 31 (et seq), 45
  8504.      CLRSCR script command 69             IEMSI script command 70
  8505.      colours 23                           IF..THEN... script command 68, 71,
  8506.      command line switches 14                                        73
  8507.      configuration 18 (et seq)            INBUFFER script function 72
  8508.      configuration file 17, 34            initialisation string 20, 46, 86,
  8509.      connect strings 22, 112, 47                                100
  8510.  
  8511.  
  8512.     PANTHER COMMUNICATIONS SOFTWARE version 2.00                  page 129
  8513.  
  8514.  
  8515.  
  8516.  
  8517.  
  8518.  
  8519.  
  8520.  
  8521.      installation 8 (et seq)                 support 7
  8522.      KEYS command line switch 15, 88,        timeslicing 5
  8523.                               109         PANTHER.BAT 13
  8524.      keystrokes and macro tokens 86       PANTHER.BIN 49, 104
  8525.      keystrokes in directory 40           PANTHER.BTM 13
  8526.      keystrokes in terminal mode 100      PANTHER.CAP 49, 107, 103
  8527.      keystrokes when on line 48           PANTHER.CFG 17, 34
  8528.      keystrokes, disabling 53             PANTHER.DIA 15
  8529.      LABEL script command 70              PANTHER.ERF 103
  8530.      line feeds 44, 50                    PANTHER.EXE 17, 117
  8531.      local echo 44, 49                    PANTHER.LOG 50, 77, 102
  8532.      log file 28, 50, 77, 102             PANTHER.MAC 85, 115
  8533.      LOGWRITE script command 70           PANTHER.RUN 35, 104
  8534.      MACRO command line switch 15, 88     PANTHER.SNP 50, 100, 103
  8535.      macro file 85, 115                   parity 43, 125
  8536.      MACRO script command 70              paths 26, 116
  8537.      Macros  84                           PAUSE script command 68
  8538.         'quit' feature 88                 port locking 21
  8539.         command line 15, 88, 109          prefix 1..5 21, 43, 86
  8540.         editing 84                        printer capture 50, 100
  8541.         examples 87                       PRINTER script command 70
  8542.         inserting pauses 85               Protocols 54
  8543.         keystroke tokens 86                  ASCII transfers 51
  8544.         keystrokes 86                        auto Zmodem downloads 28
  8545.         problems 116                         configuration 24
  8546.         running external programs 88         downloading 52, 114, 124
  8547.         summary 52                           DSZ 25, 26
  8548.      mail files 28                           errors 110, 114
  8549.      MAYGET script command 65                external 25
  8550.      MD script command 70                    in dialling directory 44
  8551.      memory requirements 6, 88               internal 54
  8552.      Mercury Communications 22, 42,          uploading 51, 114
  8553.                             86, 100          variables 25
  8554.      MESSAGE script command 70               Xmodem-1K 55
  8555.      Microsoft Windows 5                     Xmodem-1Kg 55
  8556.      MINIMUM script SPEED command 68         Xmodem/CRC 55
  8557.      MKDIR script command 70                 Ymodem-1K 55
  8558.      modem error string 21, 46               Ymodem-g 55
  8559.      modem OK string 21, 46                  Zmodem 56
  8560.      modem strings 19                        Zmodem crash recovery 56
  8561.      NOCARRIERCHECK command line             Zmodem name incrementation
  8562.                     switch 15                                      57
  8563.      NOCHECKING command line switch       QUESTIONBOX script function 72
  8564.             14, 45, 95, 99, 114, 115      queued dialling 45
  8565.      ONLINETIME script function 72        raw log viewer 61, 104, 120
  8566.      ONSCREEN script function 71          Raw Logging 28
  8567.      OS/2 5, 6, 109, 105                  RAWLOG.ANS 61, 104, 120
  8568.      Panther                              RAWLOG.AVT 61, 104, 120
  8569.         copyright 3                       RAWLOG.TXT 61, 104, 120
  8570.         development of 105                RAWLOG.V52 61, 104, 120
  8571.         directories 26, 116               RD script command 70
  8572.         hardware requirements 6           RECEIVE script command 29, 65,
  8573.         main features 4                             72, 81, 82, 108, 113
  8574.         memory requirements 6, 88         REN(AME) script command 70
  8575.         running 35
  8576.  
  8577.  
  8578.     PANTHER COMMUNICATIONS SOFTWARE version 2.00                  page 130
  8579.  
  8580.  
  8581.  
  8582.  
  8583.  
  8584.  
  8585.  
  8586.  
  8587.      REPEAT...UNTIL script command           REN(AME) command 70
  8588.                      69, 71, 72, 73          REPEAT...UNTIL command 69,
  8589.      reset string 20, 46, 86, 100                            71, 72, 73
  8590.      RMDIR script command 70                 RMDIR command 70
  8591.      run-checking file 35, 104               SEND command 60, 65, 75
  8592.      Script Files 64                         SOUND command 67
  8593.         'smart scripts' 82, 96               STOPSCRIPT command 70
  8594.         *DOWNLOADPATH variable 74            TIMEOFDAY function 72
  8595.         *FIRST variable 74                   timeout 29
  8596.         *LAST variable 74                    TRACE command 67
  8597.         *NAME variable 73                    UPLOAD command 66
  8598.         *PASSWORD variable 74                using 75
  8599.         *PROGRAMPATH variable 74             WAIT command 66
  8600.         *UPLOADPATH variable 74              WARNING command 70
  8601.         aborting 48, 96, 112                 WHILE...WEND command 69, 71,
  8602.         BEEP command 69                                               73
  8603.         CHAIN command 71                     writing
  8604.         CLRSCR command 69                 Scrollback Buffer 63
  8605.         COPY command 70                      automatic dumping 63
  8606.         DAYOFTHEWEEK function 72             saving 63
  8607.         definition 64                        viewing 51, 63, 100
  8608.         DELETE command 67                 SEND script command 60, 65, 75
  8609.         DOS command 69                    serial port configuration 19
  8610.         DOWNLOAD command 66               serial port selection 18
  8611.         editing 64, 81                    shelling to DOS 49, 100, 108
  8612.         ERASE command 67                  Snapshots
  8613.         example 77                           colour 49, 104
  8614.         EXIST function 72                    text 50, 100, 103
  8615.         FILELISTING function 72           sound 27
  8616.         GOTO command 70                   SOUND script command 67
  8617.         HANGUP command 68                 status line 48
  8618.         IEMSI command 70                  stop bits 43
  8619.         IF..THEN... command 68, 71,       STOPSCRIPT script command 70
  8620.                             73            switches 14
  8621.         in directories 42                 teletype 44, 50, 61, 100
  8622.         INBUFFER function 72              terminal emulation 44, 50, 61,
  8623.         LABEL command 70                                     100
  8624.         learning 49, 76, 108              Terminal Mode 99
  8625.         LOGWRITE command 70                  auto answer mode 101, 123
  8626.         MACRO command 70                     offline keystrokes 100
  8627.         MAYGET command 65                    online keystrokes 48, 101
  8628.         MD command 70                        problems 106
  8629.         MESSAGE command 70                TIMEOFDAY script function 72
  8630.         MINIMUM SPEED command 68          timeslicing systems 5
  8631.         MKDIR command 70                  TRACE script command 67
  8632.         ONLINETIME function 72            troubleshooting 106 (et seq)
  8633.         ONSCREEN function 71              UPLOAD script command 66
  8634.         overwrite mode 76                 uploading 51, 52, 54
  8635.         PAUSE command 68                  VT52 44, 50, 61, 100
  8636.         PRINTER command 70                WAIT script command 66
  8637.         problems 1155, 118, 120, 121      WARNING script command 70
  8638.         QUESTIONBOX function 72           WHILE...WEND script command 69,
  8639.         RD command 70                                             71, 73
  8640.         RECEIVE command 29, 65, 72,       Windows 5
  8641.                    81, 82, 108, 113       XMS (Extended memory) 7
  8642.  
  8643.  
  8644.     PANTHER COMMUNICATIONS SOFTWARE version 2.00                  page 131
  8645.  
  8646.  
  8647.